Java 中如何修改 Word 文档超链接的颜色和下划线

在日常的文档处理工作中，超链接是一个常见的元素。无论是报告、电子书还是合同文档，超链接的默认样式——蓝色文字加蓝色下划线——有时并不能满足特定的排版需求。例如，你可能希望将链接颜色改为与文档主题一致的绿色，或者为了追求简洁的视觉效果而去掉下划线。本文将介绍如何通过 Java 代码，以编程方式批量修改 Word 文档中超链接的外观样式。

涉及的技术工具

本文的实现基于一款名为 Spire.Doc for Java 的第三方库。该库是一个用于处理 Word 文档的 Java 组件，提供了文档对象模型的访问能力，支持在不安装 Microsoft Office 的情况下创建、读取、修改和保存 Word 文档。对于超链接样式的修改，该库的处理逻辑是：将超链接作为文本区域（TextRange）对象来处理，通过修改该对象的字符格式（CharacterFormat）属性，实现对颜色和下划线的控制。

环境配置步骤

在开始编写代码之前，需要将该库引入到你的 Java 项目中。如果你使用 Maven 进行依赖管理，可以在 pom.xml 文件中添加以下配置：

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.doc</artifactId>
        <version>14.6.0</version>
    </dependency>
</dependencies>

如果你不使用 Maven，也可以直接获取 JAR 文件并将其手动添加到项目的构建路径中。

核心实现方法

在该库的 API 设计中，向段落中添加超链接是通过 Paragraph.appendHyperlink() 方法完成的。该方法接收三个参数：链接地址、显示文本和链接类型。调用该方法后会返回一个 TextRange 对象，该对象代表了超链接的显示文本部分。

通过 TextRange.getCharacterFormat() 方法可以获取字符格式对象 CharacterFormat，随后可以调用以下两个方法进行样式设置：

setTextColor(Color color)：设置文字颜色，参数为 java.awt.Color 对象，支持 RGB 自定义颜色
setUnderlineStyle(UnderlineStyle style)：设置下划线样式，参数可选值包括 UnderlineStyle.Single （单下划线）和 UnderlineStyle.None （无下划线）等

完整代码示例

以下示例代码演示了如何创建一个包含三个超链接的 Word 文档，分别展示默认样式、自定义红色样式以及无下划线样式：

import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.Section;
import com.spire.doc.documents.BreakType;
import com.spire.doc.documents.HyperlinkType;
import com.spire.doc.documents.Paragraph;
import com.spire.doc.documents.UnderlineStyle;
import com.spire.doc.fields.TextRange;
import java.awt.Color;

public class ModifyHyperlinkDemo {
    public static void main(String[] args) {
        // 创建文档对象
        Document document = new Document();
        Section section = document.addSection();

        // 示例1：默认样式的超链接
        Paragraph para1 = section.addParagraph();
        para1.appendText("示例1 - 默认样式：");
        TextRange link1 = para1.appendHyperlink("https://www.example.com", 
                "Example Website", HyperlinkType.Web_Link);
        link1.getCharacterFormat().setFontSize(12f);
        para1.appendBreak(BreakType.Line_Break);

        // 示例2：修改文字颜色为红色
        Paragraph para2 = section.addParagraph();
        para2.appendText("示例2 - 红色文字：");
        TextRange link2 = para2.appendHyperlink("https://www.example.com", 
                "Red Colored Link", HyperlinkType.Web_Link);
        link2.getCharacterFormat().setFontSize(12f);
        link2.getCharacterFormat().setTextColor(Color.RED);
        para2.appendBreak(BreakType.Line_Break);

        // 示例3：移除下划线
        Paragraph para3 = section.addParagraph();
        para3.appendText("示例3 - 无下划线：");
        TextRange link3 = para3.appendHyperlink("https://www.example.com", 
                "No Underline Link", HyperlinkType.Web_Link);
        link3.getCharacterFormat().setFontSize(12f);
        link3.getCharacterFormat().setUnderlineStyle(UnderlineStyle.None);
        para3.appendBreak(BreakType.Line_Break);

        // 保存文档
        String outputPath = "HyperlinkStyleDemo.docx";
        document.saveToFile(outputPath, FileFormat.Docx_2013);
        System.out.println("文档已生成：" + outputPath);
    }
}

运行结果说明

执行上述代码后，会在项目根目录下生成一个名为 HyperlinkStyleDemo.docx 的 Word 文档。打开该文档可以看到三个超链接的效果差异：

第一个链接：蓝色文字，带有默认的单下划线
第二个链接：红色文字，仍然保留了下划线
第三个链接：蓝色文字，下划线已被成功移除

处理已有文档中的超链接

前面的示例演示的是在新建文档时控制超链接的样式。在实际开发中，更常见的需求可能是修改一个已有的 Word 文档中的所有超链接样式。例如，你可能需要将一个从网页复制而来的文档中的所有超链接下划线统一去掉。

对于这种场景，实现思路略有不同。基本步骤如下：

使用 Document.loadFromFile() 方法加载现有的 Word 文档
遍历文档中的所有段落（通过 Section 获取 Paragraph 集合）
遍历每个段落中的子元素，识别类型为 Field 且字段类型为 FieldType.FieldHyperlink 的对象
获取该字段关联的 TextRange 对象，然后调用字符格式修改方法
保存修改后的文档

这种方式适用于批量统一调整已有文档的链接风格。

常见问题与注意事项

在实际使用过程中，有几点需要留意：

第一，超链接的显示文本本质上是一个 TextRange 对象，所有字体属性都需要通过 CharacterFormat 进行设置，这一点与普通文本的处理方式是一致的。

第二，颜色修改使用 setTextColor() 方法时，传入的 Color 对象支持 RGB 构造函数，例如 new Color(0, 128, 0) 可以设置绿色。

第三，下划线样式的移除需要显式调用 setUnderlineStyle(UnderlineStyle.None)。如果只是不设置任何值，链接会保留 Word 默认的下划线样式。

第四，对于已有文档中的超链接，需要通过字段识别的方式获取 TextRange，而不能直接使用 appendHyperlink 的返回值。这是因为已有文档中的超链接结构与新创建的有所不同。

结语

通过本文介绍的方法，开发者可以在 Java 应用中实现对 Word 文档超链接外观的编程控制。无论是生成新文档时的样式预设，还是批量处理已有文档时的样式统一，都可以在不依赖本地 Office 环境的前提下完成。这为文档自动化生成、报告定制、电子书制作等场景提供了一种可行的技术方案。本文提供的代码示例可以直接用于实际项目中，开发者也可以根据具体需求进行功能扩展，例如按链接类型分别设置不同样式，或根据链接目标域名动态调整颜色等。

Java 中如何修改 Word 文档超链接的颜色和下划线