Word 文檔常用于撰寫報(bào)告、合同、通知、技術(shù)文檔等。當(dāng)文檔內(nèi)容較多時(shí)，如果需要修改或替換某些詞語、短語，甚至是格式化文本，手動(dòng)操作往往效率很低。例如：

• 批量替換合同中的客戶姓名或公司名稱。
• 修改大篇幅技術(shù)文檔中的術(shù)語。
• 用新的品牌名替換舊品牌名。
• 批量更新文檔中的格式化數(shù)據(jù)（如電話號(hào)碼、日期等）。

在這種情況下，使用編程方式批量替換 Word 文檔內(nèi)容，不僅可以大幅節(jié)省時(shí)間，還能避免人為操作的失誤。這篇文章將分享如何使用 Java 高效實(shí)現(xiàn)批量替換 Word 文檔文字內(nèi)容，包括幾種常見的替換方式，例如：替換所有匹配項(xiàng)、替換第一個(gè)匹配項(xiàng)、使用正則表達(dá)式替換、批量替換多個(gè)詞匯，以及將文字替換為圖片等。

準(zhǔn)備工作

為實(shí)現(xiàn) Word 文檔文字替換功能，這篇文章使用了 Spire.Doc for Java 庫。它提供了豐富的 API，可以方便地操作 Word 文檔，包括生成、讀取、修改、格式化等，且無需安裝微軟Office。

安裝方法

如果使用 Maven 管理項(xiàng)目，可以在 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>13.8.7</version>
    </dependency>
</dependencies>

如果不是 Maven 項(xiàng)目，可以直接從 E-iceblue 官方網(wǎng)站下載 jar 包，并手動(dòng)導(dǎo)入到項(xiàng)目中。引入完成后，就可以在 Java 項(xiàng)目中使用 import com.spire.doc.* 導(dǎo)入該庫的類來操作 Word 文檔了。

替換操作詳解

下面將對(duì)每種常見的替換操作進(jìn)行詳細(xì)介紹，包括替換單個(gè)文字的所有匹配項(xiàng)及第一個(gè)匹配項(xiàng)，使用正則表達(dá)式替換文字，批量替換多個(gè)文字，以及將文字替換為圖片等。

1. 替換所有匹配項(xiàng)

在許多情況下，文檔中會(huì)有多個(gè)相同的文本內(nèi)容需要批量替換。例如，你可能想要把所有的“舊公司”替換為“新公司”。通過使用 replace 方法，我們能夠快速替換文檔中所有匹配的文本。

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)：替換所有匹配的文本。第三個(gè)參數(shù) true 表示區(qū)分大小寫，第四個(gè)參數(shù) true 表示完全匹配。
• document.saveToFile("output_replace_all.docx", FileFormat.Docx_2013)：保存修改后的文檔。

這種方法簡(jiǎn)單直接，適合于需要批量替換文檔中所有特定文本的場(chǎng)景。

2. 替換第一個(gè)匹配項(xiàng)

有時(shí)，我們并不需要替換文檔中所有的匹配項(xiàng)，而只是希望替換第一個(gè)出現(xiàn)的匹配項(xiàng)。例如，我們只想替換文檔中的第一個(gè)“舊公司”而保留后續(xù)的相同詞匯。

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)：只替換第一個(gè)匹配項(xiàng)。
• document.replace(...)：執(zhí)行替換操作。
• document.saveToFile(...)：保存修改后的文檔。

這種方法適用于當(dāng)你只想替換文檔中的第一個(gè)匹配項(xiàng)時(shí)。

3. 使用正則表達(dá)式替換

對(duì)于復(fù)雜的文本替換需求，我們可以使用正則表達(dá)式。例如，我們可以用正則表達(dá)式查找匹配某種格式的文本，如日期格式 yyyy-MM-dd，并將其替換為統(tǒng)一的日期格式。

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)：定義正則表達(dá)式。
• document.replace(Pattern.compile(regex), replacement)：替換匹配內(nèi)容。

通過正則表達(dá)式，能夠靈活匹配復(fù)雜的文本模式，適用于有一定規(guī)律的文本替換場(chǎng)景。

4. 批量替換多個(gè)詞匯（使用 Map）

使用 Map 存儲(chǔ)多個(gè)替換規(guī)則。

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 存儲(chǔ)多個(gè)替換規(guī)則，鍵是需要替換的詞匯，值是替換后的內(nèi)容。
• for (Map.Entry<String, String> entry : replaceMap.entrySet())：遍歷 Map 中的每個(gè)條目。
• document.replace(entry.getKey(), entry.getValue(), true, true)：使用 replace 方法替換 Map 中每對(duì)鍵值對(duì)的詞匯。

這種方法適用于當(dāng)文檔中需要批量更新多個(gè)詞匯時(shí)。

5. 將文字替換為圖片

有時(shí)我們不僅僅需要替換文字，還需要將文字替換為圖像，比如把簽名或徽標(biāo)替換為圖片。通過獲取目標(biāo)文字的位置，然后插入圖片到該位置并刪除文字的方法，我們可以將文本替換為圖片。

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 數(shù)組。參數(shù) true, true 分別表示區(qū)分大小寫和全詞匹配。
• for (Object obj : selections)：遍歷所有匹配項(xiàng)，每個(gè)對(duì)象表示一次匹配，便于逐個(gè)處理。
• TextSelection textSelection = (TextSelection) obj：將遍歷對(duì)象轉(zhuǎn)換為 TextSelection，獲取匹配文本的相關(guān)信息。
• DocPicture picture = new DocPicture(document) 與 picture.loadImage("signature.png")：創(chuàng)建圖片對(duì)象并加載要替換的圖片。
• TextRange range = textSelection.getAsOneRange()：獲取匹配文字的 TextRange 對(duì)象，用于確定文字在段落中的位置。
• int index = range.getOwnerParagraph().getChildObjects().indexOf(range)：獲取匹配文字在段落子對(duì)象列表中的索引位置，確保圖片插入到正確位置。
• range.getOwnerParagraph().getChildObjects().insert(index, picture)：將圖片插入到原文字所在的位置。
• range.getOwnerParagraph().getChildObjects().remove(range)：刪除原文字“簽名”，完成替換。

這種方法可以將文檔中的文字替換為圖像，適合用于合同、報(bào)告等需要插入簽名或品牌 Logo 的場(chǎng)景。

總結(jié)

本文通過詳細(xì)示例展示了如何使用 Java 批量替換 Word 文檔中的文字內(nèi)容，包括全局替換、局部替換、正則替換、批量替換及文字替換為圖片等方法。這些方法能幫助開發(fā)者快速實(shí)現(xiàn)文檔內(nèi)容自動(dòng)化處理，減少人工操作錯(cuò)誤，提高工作效率。

以上就是Java輕松批量替換Word文檔文字內(nèi)容的操作步驟的詳細(xì)內(nèi)容，更多關(guān)于Java批量替換Word內(nèi)容的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！