Java輕松批量替換Word文檔文字內(nèi)容的操作步驟

更新時間：2025年09月18日 17:14:39 作者：用戶372157426135

Word 文檔常用于撰寫報告、合同、通知、技術文檔等,當文檔內(nèi)容較多時,如果需要修改或替換某些詞語、短語,甚至是格式化文本,手動操作往往效率很低,所以本文給大家介紹了Java實現(xiàn)輕松批量替換Word文檔文字內(nèi)容,需要的朋友可以參考下

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

準備工作

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

安裝方法

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

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

替換操作詳解

下面將對每種常見的替換操作進行詳細介紹，包括替換單個文字的所有匹配項及第一個匹配項，使用正則表達式替換文字，批量替換多個文字，以及將文字替換為圖片等。

1. 替換所有匹配項

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

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

2. 替換第一個匹配項

有時，我們并不需要替換文檔中所有的匹配項，而只是希望替換第一個出現(xiàn)的匹配項。例如，我們只想替換文檔中的第一個“舊公司”而保留后續(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)：只替換第一個匹配項。
document.replace(...)：執(zhí)行替換操作。
document.saveToFile(...)：保存修改后的文檔。

這種方法適用于當你只想替換文檔中的第一個匹配項時。

3. 使用正則表達式替換

對于復雜的文本替換需求，我們可以使用正則表達式。例如，我們可以用正則表達式查找匹配某種格式的文本，如日期格式 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)：定義正則表達式。
document.replace(Pattern.compile(regex), replacement)：替換匹配內(nèi)容。

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

4. 批量替換多個詞匯（使用 Map）

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

這種方法適用于當文檔中需要批量更新多個詞匯時。

5. 將文字替換為圖片

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

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)：遍歷所有匹配項，每個對象表示一次匹配，便于逐個處理。
TextSelection textSelection = (TextSelection) obj：將遍歷對象轉換為 TextSelection，獲取匹配文本的相關信息。
DocPicture picture = new DocPicture(document) 與 picture.loadImage("signature.png")：創(chuàng)建圖片對象并加載要替換的圖片。
TextRange range = textSelection.getAsOneRange()：獲取匹配文字的 TextRange 對象，用于確定文字在段落中的位置。
int index = range.getOwnerParagraph().getChildObjects().indexOf(range)：獲取匹配文字在段落子對象列表中的索引位置，確保圖片插入到正確位置。
range.getOwnerParagraph().getChildObjects().insert(index, picture)：將圖片插入到原文字所在的位置。
range.getOwnerParagraph().getChildObjects().remove(range)：刪除原文字“簽名”，完成替換。

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