提供一种使用Java代码批量移除Word文档中超链接的方法。通过遍历段落中的文本范围或图片对象，可选择仅移除链接属性保留文字，或彻底删除链接及其显示内容。该方法无需安装Office，适合后端自动化处理。
好的，没问题。作为一名在文档自动化领域摸爬滚打多年的老手，今天来聊聊一个非常实际的问题：Word文档里的超链接清理。
很多时候，我们从网页或者第三方系统导出的Word文件，里面塞满了各种外部链接。在内部归档、打印或者准备分发给其他人时，这些链接就显得很碍眼，甚至可能引发误点击，影响文档的整洁和专业性。还有些场景，我们需要把带链接的文档转成纯文本存档，那就必须先把这些“隐形”的跳转结构剥离掉。
下面，我将演示如何用Ja va代码，在不装Office的情况下，批量搞定Word文档里的超链接。你可以选择只去掉链接功能，保留文字；也可以把链接和它的显示文字一并删除。
### 1. 准备工作：环境配置
开始动手前，得先把用到的工具引入项目。如果你用的是Ma ven，在`pom.xml`里加上下面这几行就行。
```xml
com.e-iceblue
e-iceblue
https://repo.e-iceblue.cn/repository/ma ven-public/
e-iceblue
spire.doc
14.6.0
```
如果你不用Ma ven，手动下载JAR包丢到项目路径里也是一样的。关键是，这个库能在没有Office的
服务器上独立运行，这点对于后端自动化任务来说太重要了。
### 2. 摸清门路：库里的超链接长什么样？
操作之前，得先知道这个库是怎么看待“超链接”的。在它内部，超链接并不是一个独立的大对象，而是藏在段落（`Paragraph`）里的一个“小零件”。具体来说，文本超链接表现为一个`TextRange`对象，并且它的`getCharacterFormat().isHyperlink()`方法返回的是`true`。
想要抓到文档里所有的超链接，就得一层层地遍历：先遍历每个节（Section），再遍历节里的每个段落（Paragraph），最后在段落里找到那个带链接属性的`TextRange`。
### 3. 最常用的操作：只去链接，保留文字
这应该是你碰到最多的需求了：把 `
` 这种可点击的链接，变成普通文字的 `https://example.com`；或者把“点击查看详情”这种带下划线的链接文字，保留成普通文字。
思路很简单：找到那个有链接属性的`TextRange`，然后调用`getCharacterFormat().setHyperlink(false)`，把它的超链接标记给关掉。文字原封不动，只是不再能点击跳转。
下面这段代码演示的就是这个逻辑：
```ja va
import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.Section;
import com.spire.doc.documents.Paragraph;
import com.spire.doc.fields.TextRange;
public class RemoveHyperlinkKeepText {
public static void main(String[] args) {
// 加载文档
Document doc = new Document();
doc.loadFromFile("Input.docx");
// 遍历所有段落
for (Section section : doc.getSections()) {
for (Paragraph para : section.getParagraphs()) {
for (Object obj : para.getChildObjects()) {
if (obj instanceof TextRange) {
TextRange range = (TextRange) obj;
if (range.getCharacterFormat().isHyperlink()) {
// 关键一步：清除链接属性
range.getCharacterFormat().setHyperlink(false);
}
}
}
}
}
// 保存结果
doc.sa veToFile("Output_NoHyperlink.docx", FileFormat.Docx_2013);
System.out.println("搞定！链接功能移除，文字保留。");
}
}
```
### 4. 彻底操作：链接和文字一并删除
有些场景下，要求更高。比如文档末尾有一堆“参考资料”的外部URL，内部版本根本不需要这些内容，那就得连文字带链接一起删掉。
这时候，我们要的是删除整个`TextRange`对象。不过，这里有个坑：你不能在遍历`getChildObjects()`集合的同时，直接调用它的`remove`方法，这会引发并发修改的异常。正确的做法是：**先记下来要删哪些对象，遍历结束后再统一清理**。
看看这段代码怎么处理：
```ja va
import com.spire.doc.Document;
import com.spire.doc.Section;
import com.spire.doc.documents.Paragraph;
import com.spire.doc.fields.TextRange;
import ja va.util.ArrayList;
import ja va.util.List;
public class RemoveHyperlinkCompletely {
public static void main(String[] args) {
Document doc = new Document();
doc.loadFromFile("Input.docx");
for (Section section : doc.getSections()) {
for (Paragraph para : section.getParagraphs()) {
// 先建一个“待删除清单”
List toRemove = new ArrayList<>();
for (Object obj : para.getChildObjects()) {
if (obj instanceof TextRange) {
TextRange range = (TextRange) obj;
if (range.getCharacterFormat().isHyperlink()) {
toRemove.add(range);
}
}
}
// 遍历完再动手
for (TextRange range : toRemove) {
para.getChildObjects().remove(range);
}
}
}
doc.sa veToFile("Output_NoLinkAndText.docx", FileFormat.Docx_2013);
System.out.println("搞定！链接和文字都清掉了。");
}
}
```
### 5. 别忘了它：处理图片超链接
除了文字，文档里还可能有图片超链接，就是点击一张图片跳转到某个页面。这种链接的对象类型是`DocPicture`，而不是`TextRange`。处理方式类似，我们需要找到`DocPicture`对象，然后把它绑定的超链接给解除掉。
```ja va
import com.spire.doc.fields.DocPicture;
// 在遍历段落子对象时，增加对 DocPicture 的判断
for (Object obj : para.getChildObjects()) {
if (obj instanceof DocPicture) {
DocPicture picture = (DocPicture) obj;
// 检查图片是否带有超链接并解除绑定
if (picture.getHyperlink() != null) {
picture.setHyperlink(null);
}
}
}
```
提醒一下，不同版本的API，图片超链接的获取方法名可能略有不同。如果 `getHyperlink` / `setHyperlink` 用不了，可以查一下对应版本的文档，或者试试`picture.getCharacterFormat().isHyperlink()`。
### 6. 整合一下：一个处理所有情况的示例
最后，把上面几种情况整合到一起，形成一个通用的解决方案。这段代码会加载一个文档，移除所有文字超链接的属性（保留文字），同时解除所有图片超链接的绑定。
```ja va
import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.Section;
import com.spire.doc.documents.Paragraph;
import com.spire.doc.fields.DocPicture;
import com.spire.doc.fields.TextRange;
public class ComprehensiveRemoveHyperlink {
public static void main(String[] args) {
// 加载文档
Document doc = new Document();
doc.loadFromFile("DocumentWithLinks.docx");
// 遍历
for (Section section : doc.getSections()) {
for (Paragraph para : section.getParagraphs()) {
for (Object obj : para.getChildObjects()) {
// 文字超链接：只去链接属性
if (obj instanceof TextRange) {
TextRange range = (TextRange) obj;
if (range.getCharacterFormat().isHyperlink()) {
range.getCharacterFormat().setHyperlink(false);
}
}
// 图片超链接：断开绑定
else if (obj instanceof DocPicture) {
DocPicture picture = (DocPicture) obj;
if (picture.getHyperlink() != null) {
picture.setHyperlink(null);
}
}
}
}
}
// 保存
doc.sa veToFile("CleanedDocument.docx", FileFormat.Docx_2013);
System.out.println("文档中的超链接已全部清理完毕！");
}
}
```
### 7. 应用场景与几个提醒
这种方法非常适合在Ja va后端服务里批量处理Word文档。比如：
- 把网页导出的文档转成干净的内部归档版本。
- 打印前批量去除所有可点击元素，免得纸质版上出现误导性的下划线。
- 清洗第三方系统来的文档，以满足内部的内容安全规范。
有几个技术细节值得注意：
- **集合安全：** 再次强调，遍历集合的时候不要直接删除元素，用“先收集、后删除”的模式。
- **API差异：** 不同版本的库，图片超链接的处理方法可能不一样，如果代码跑不通，记得去查一下当前版本的API文档。
- **输出格式：** 处理完的文档，可以按需存成`.docx`、`.doc`甚至PDF格式。但要记住，转成PDF后，链接的行为是由PDF阅读器决定的，我们的代码只管Word里的链接。
- **运行环境：** 这个库不依赖Office，在Windows和Linux上都跑得溜，非常适合做服务端的自动化任务。 
