Java 实现 Word 文档文本查找与高亮标注

在文档审阅与信息提炼过程中，快速定位特定关键词并对其进行视觉标注是一项高频需求。无论是用于文档自查、重点标记，还是自动化生成审阅意见，将查找与高亮功能结合都能显著提升工作效率。本文将介绍如何利用 Java 语言，基于第三方文档处理库实现 Word 文档中文本的查找与高亮操作。

环境配置

本文示例所使用的库为 Spire.Doc for Java。若使用 Maven 管理项目依赖，可在 pom.xml 中添加以下配置：

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 文件并添加到项目的类路径中。

查找并高亮所有匹配文本

当需要对文档中所有出现的特定关键词进行高亮标注时，可使用 Document.findAllString() 方法。该方法返回一个 TextSelection 数组，包含文档中所有匹配的文本位置，开发者可遍历该数组并对每个匹配项应用高亮格式。

java 复制代码

import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.documents.TextSelection;
import java.awt.Color;

public class HighlightAllMatches {
    public static void main(String[] args) {
        // 加载Word文档
        Document document = new Document();
        document.loadFromFile("示例文档.docx");

        // 查找所有匹配的文本
        // 参数说明：搜索字符串、是否区分大小写、是否全字匹配
        TextSelection[] selections = document.findAllString("关键指标", false, true);

        // 为每个匹配项设置高亮颜色
        for (TextSelection selection : selections) {
            selection.getAsOneRange()
                .getCharacterFormat()
                .setHighlightColor(Color.YELLOW);
        }

        // 保存修改后的文档
        document.saveToFile("高亮所有匹配项.docx", FileFormat.Docx_2013);
        document.dispose();
    }
}

findAllString() 方法提供两个布尔参数：第二个参数控制是否区分大小写，第三个参数控制是否全字匹配。合理设置这两个参数可避免非预期的匹配结果。

查找并高亮第一个匹配项

某些场景下，开发者仅需处理目标文本的首次出现，例如在文档开头标注首个关键术语。此时可使用 Document.findString() 方法，该方法仅返回第一个匹配的 TextSelection 对象。

java 复制代码

import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.documents.TextSelection;
import java.awt.Color;

public class HighlightFirstMatch {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("示例文档.docx");

        // 查找第一个匹配的文本
        TextSelection selection = document.findString("关键指标", false, true);

        if (selection != null) {
            selection.getAsOneRange()
                .getCharacterFormat()
                .setHighlightColor(Color.CYAN);
        }

        document.saveToFile("高亮第一个匹配项.docx", FileFormat.Docx_2013);
        document.dispose();
    }
}

需要注意的是，findString() 方法在未找到匹配项时返回 null，因此建议在使用前进行非空判断，避免空指针异常。

高亮颜色的选择

setHighlightColor() 方法接受 java.awt.Color 对象作为参数，支持多种标准颜色：

颜色常量	说明
`Color.YELLOW`	黄色（Word 默认高亮色）
`Color.CYAN`	青色
`Color.GREEN`	绿色
`Color.PINK`	粉色
`Color.RED`	红色

高亮色与文字颜色需保持足够对比度，以确保阅读体验。

实际应用场景

文本查找与高亮功能在多个业务场景中具有实用价值：

文档审阅：自动标注合同或报告中的关键条款、日期、金额等敏感信息
内容校对：高亮待修订或待确认的文本片段
知识管理：对技术文档中的术语进行快速标注，便于读者识别
自动化报告：在生成报告后高亮重要结论或数据

注意事项

查找精度 ：findAllString() 和 findString() 方法均支持区分大小写和全字匹配。在处理英文文档时，区分大小写可避免 "Java" 与 "java" 混同；全字匹配可防止 "cat" 匹配到 "category"。

资源管理 ：操作完成后调用 dispose() 方法释放文档对象占用的资源，是规范的编码实践。

文档兼容性 ：高亮效果在 Word 2013 及以上版本中得到良好支持。保存时建议使用 FileFormat.Docx_2013 或更新版本。

总结

本文介绍了基于 Java 语言在 Word 文档中实现文本查找与高亮标注的技术方案。通过 Document.findAllString() 方法可一次性定位并处理所有匹配文本，适用于批量标注场景；Document.findString() 方法则仅处理首次匹配项，适合快速定位需求。两种方法均通过 TextRange.getCharacterFormat().setHighlightColor() 设置高亮颜色，操作路径清晰、代码简洁。该功能在文档自动化处理流程中具有较高的实用价值，能够帮助开发者快速实现关键词标注与内容审核等任务，在合同审查、报告生成和技术文档处理等场景中可发挥实际作用。