Java 轻松批量替换 Word 文档文字内容

Word 文档常用于撰写报告、合同、通知、技术文档等。当文档内容较多时，如果需要修改或替换某些词语、短语，甚至是格式化文本，手动操作往往效率很低。例如：

批量替换合同中的客户姓名或公司名称。
修改大篇幅技术文档中的术语。
用新的品牌名替换旧品牌名。
批量更新文档中的格式化数据（如电话号码、日期等）。

在这种情况下，使用编程方式批量替换 Word 文档内容，不仅可以大幅节省时间，还能避免人为操作的失误。这篇文章将分享如何使用 Java 高效实现批量替换 Word 文档文字内容，包括几种常见的替换方式，例如：替换所有匹配项、替换第一个匹配项、使用正则表达式替换、批量替换多个词汇，以及将文字替换为图片等。

准备工作

为实现 Word 文档文字替换功能，这篇文章使用了 Spire.Doc for Java 库。它提供了丰富的 API，可以方便地操作 Word 文档，包括生成、读取、修改、格式化等，且无需安装微软Office。

安装方法

如果使用 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>13.8.7</version>
    </dependency>
</dependencies>

如果不是 Maven 项目，可以直接从 E-iceblue 官方网站下载 jar 包，并手动导入到项目中。引入完成后，就可以在 Java 项目中使用 import com.spire.doc.* 导入该库的类来操作 Word 文档了。

替换操作详解

下面将对每种常见的替换操作进行详细介绍，包括替换单个文字的所有匹配项及第一个匹配项，使用正则表达式替换文字，批量替换多个文字，以及将文字替换为图片等。

1. 替换所有匹配项

在许多情况下，文档中会有多个相同的文本内容需要批量替换。例如，你可能想要把所有的"旧公司"替换为"新公司"。通过使用 replace 方法，我们能够快速替换文档中所有匹配的文本。

java 复制代码

import com.spire.doc.*;

public class ReplaceAllExample {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("input.docx");
        document.replace("旧公司", "新公司", true, true);
        document.saveToFile("output_replace_all.docx", FileFormat.Docx_2013);
    }
}

代码解析：

document.loadFromFile("input.docx")：加载 Word 文档。
document.replace("旧公司", "新公司", true, true)：替换所有匹配的文本。第三个参数 true 表示区分大小写，第四个参数 true 表示完全匹配。
document.saveToFile("output_replace_all.docx", FileFormat.Docx_2013)：保存修改后的文档。

这种方法简单直接，适合于需要批量替换文档中所有特定文本的场景。

2. 替换第一个匹配项

有时，我们并不需要替换文档中所有的匹配项，而只是希望替换第一个出现的匹配项。例如，我们只想替换文档中的第一个"旧公司"而保留后续的相同词汇。

java 复制代码

import com.spire.doc.*;

public class ReplaceFirstExample {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("input.docx");
        document.setReplaceFirst(true);
        document.replace("旧公司", "新公司", true, true);
        document.saveToFile("output_replace_first.docx", FileFormat.Docx_2013);
    }
}

代码解析：

document.setReplaceFirst(true)：只替换第一个匹配项。
document.replace(...)：执行替换操作。
document.saveToFile(...)：保存修改后的文档。

这种方法适用于当你只想替换文档中的第一个匹配项时。

3. 使用正则表达式替换

对于复杂的文本替换需求，我们可以使用正则表达式。例如，我们可以用正则表达式查找匹配某种格式的文本，如日期格式 yyyy-MM-dd，并将其替换为统一的日期格式。

java 复制代码

import com.spire.doc.*;
import java.util.regex.*;

public class ReplaceRegexExample {
    public static void main(String[] args) throws Exception {
        Document document = new Document();
        document.loadFromFile("input.docx");
        String regex = "2025-\d{2}-\d{2}";
        String replacement = "2025-01-01";
        document.replace(Pattern.compile(regex), replacement);
        document.saveToFile("output_replace_regex.docx", FileFormat.Docx_2013);
    }
}

代码解析：

Pattern.compile(regex)：定义正则表达式。
document.replace(Pattern.compile(regex), replacement)：替换匹配内容。

通过正则表达式，能够灵活匹配复杂的文本模式，适用于有一定规律的文本替换场景。

4. 批量替换多个词汇（使用 Map）

使用 Map 存储多个替换规则。

java 复制代码

import com.spire.doc.*;
import java.util.*;

public class ReplaceMultipleExample {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("input.docx");
        Map<String, String> replaceMap = new HashMap<>();
        replaceMap.put("旧公司", "新公司");
        replaceMap.put("客户A", "李四");
        replaceMap.put("客户B", "王五");
        for (Map.Entry<String, String> entry : replaceMap.entrySet()) {
            document.replace(entry.getKey(), entry.getValue(), true, true);
        }
        document.saveToFile("output_replace_multiple.docx", FileFormat.Docx_2013);
    }
}

代码解析：

Map<String, String> replaceMap = new HashMap<>()：使用 Map 存储多个替换规则，键是需要替换的词汇，值是替换后的内容。
for (Map.Entry<String, String> entry : replaceMap.entrySet())：遍历 Map 中的每个条目。
document.replace(entry.getKey(), entry.getValue(), true, true)：使用 replace 方法替换 Map 中每对键值对的词汇。

这种方法适用于当文档中需要批量更新多个词汇时。

5. 将文字替换为图片

有时我们不仅仅需要替换文字，还需要将文字替换为图像，比如把签名或徽标替换为图片。通过获取目标文字的位置，然后插入图片到该位置并删除文字的方法，我们可以将文本替换为图片。

java 复制代码

import com.spire.doc.Document;
import com.spire.doc.documents.TextSelection;
import com.spire.doc.fields.DocPicture;
import com.spire.doc.fields.TextRange;
import com.spire.doc.FileFormat;

public class ReplaceSignatureWithImage {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("input.docx");
        TextSelection[] selections = document.findAllString("签名", true, true);
        for (Object obj : selections) {
            TextSelection textSelection = (TextSelection) obj;
            DocPicture picture = new DocPicture(document);
            picture.loadImage("signature.png");
            TextRange range = textSelection.getAsOneRange();
            int index = range.getOwnerParagraph().getChildObjects().indexOf(range);
            range.getOwnerParagraph().getChildObjects().insert(index, picture);
            range.getOwnerParagraph().getChildObjects().remove(range);
        }
        document.saveToFile("output_signature.docx", FileFormat.Docx_2013);
        System.out.println("文字"签名"已成功替换为图片");
    }
}

代码解析：

TextSelection[] selections = document.findAllString("签名", true, true)：查找文档中所有匹配"签名"的文本，返回 TextSelection 数组。参数 true, true 分别表示区分大小写和全词匹配。
for (Object obj : selections)：遍历所有匹配项，每个对象表示一次匹配，便于逐个处理。
TextSelection textSelection = (TextSelection) obj：将遍历对象转换为 TextSelection，获取匹配文本的相关信息。
DocPicture picture = new DocPicture(document) 与 picture.loadImage("signature.png")：创建图片对象并加载要替换的图片。
TextRange range = textSelection.getAsOneRange()：获取匹配文字的 TextRange 对象，用于确定文字在段落中的位置。
int index = range.getOwnerParagraph().getChildObjects().indexOf(range)：获取匹配文字在段落子对象列表中的索引位置，确保图片插入到正确位置。
range.getOwnerParagraph().getChildObjects().insert(index, picture)：将图片插入到原文字所在的位置。
range.getOwnerParagraph().getChildObjects().remove(range)：删除原文字"签名"，完成替换。

这种方法可以将文档中的文字替换为图像，适合用于合同、报告等需要插入签名或品牌 Logo 的场景。

总结

本文通过详细示例展示了如何使用 Java 批量替换 Word 文档中的文字内容，包括全局替换、局部替换、正则替换、批量替换及文字替换为图片等方法。这些方法能帮助开发者快速实现文档内容自动化处理，减少人工操作错误，提高工作效率。