Java操作Word文檔的常用功能實(shí)踐指南

更新時(shí)間：2026年04月13日 10:38:28 作者：缺點(diǎn)內(nèi)向

在 Java 后端開發(fā)中,與 Word 文檔打交道是一項(xiàng)繞不開的需求,本文記錄幾種常見的 Word 編輯操作,供有類似需求的開發(fā)者參考,希望對(duì)大家有所幫助

在 Java 后端開發(fā)中，與 Word 文檔打交道是一項(xiàng)繞不開的需求。無(wú)論是生成業(yè)務(wù)報(bào)告、導(dǎo)出合同模板、還是處理用戶上傳的文檔內(nèi)容，都需要一套穩(wěn)定可用的文檔處理方案。本文記錄幾種常見的 Word 編輯操作，供有類似需求的開發(fā)者參考。

環(huán)境配置

在 Maven 項(xiàng)目中，需要在 pom.xml 中添加以下倉(cāng)庫(kù)和依賴配置：

<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.9.19</version>
    </dependency>
</dependencies>

如果不使用 Maven，也可以手動(dòng)下載 JAR 包并添加到項(xiàng)目的 ClassPath 中。該庫(kù)提供免費(fèi)版本，使用時(shí)需注意其限制條件：加載或保存 Word 文檔時(shí)，不超過(guò) 500 個(gè)段落和 25 個(gè)表格；轉(zhuǎn)換為 PDF 等格式時(shí)僅支持前 3 頁(yè)內(nèi)容。實(shí)際項(xiàng)目中需根據(jù)業(yè)務(wù)文檔的規(guī)模評(píng)估是否滿足需求。

此外，該組件無(wú)需安裝 Microsoft Office 環(huán)境即可獨(dú)立運(yùn)行，對(duì)于部署在服務(wù)端的應(yīng)用程序而言較為便利。

功能一：文本查找與替換

文本替換是 Word 編輯中最基礎(chǔ)的操作之一，常用于動(dòng)態(tài)填充模板中的占位符。通過(guò) replace 方法可以定位文檔中的指定文本并一次性替換所有匹配項(xiàng)。如果只需要替換第一個(gè)匹配項(xiàng)，可先調(diào)用 setReplaceFirst(true) 設(shè)置替換模式。

import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import java.util.HashMap;
import java.util.Map;

public class TextReplaceExample {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("template.docx");
        
        // 定義替換映射
        Map<String, String> replaceMap = new HashMap<>();
        replaceMap.put("#name#", "張三");
        replaceMap.put("#date#", "2026年4月13日");
        replaceMap.put("#amount#", "￥12,800");
        
        // 執(zhí)行替換
        for (Map.Entry<String, String> entry : replaceMap.entrySet()) {
            document.replace(entry.getKey(), entry.getValue(), true, true);
        }
        
        document.saveToFile("output.docx", FileFormat.Docx);
        document.dispose();
    }
}

replace 方法的第三、第四個(gè)參數(shù)分別表示是否區(qū)分大小寫和是否全字匹配，可根據(jù)實(shí)際需要調(diào)整。如果模板中的占位符采用 ${變量名} 的格式，也可以結(jié)合正則表達(dá)式 findAllPattern 進(jìn)行更靈活的匹配。

功能二：基于書簽修改內(nèi)容

書簽是 Word 中一種實(shí)用的定位標(biāo)記，特別適合在結(jié)構(gòu)復(fù)雜的文檔中精準(zhǔn)替換內(nèi)容。相比文本占位符，書簽?zāi)軌蚓_定位，且替換后不會(huì)丟失書簽本身，便于后續(xù)再次更新。

import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.documents.BookmarksNavigator;
import java.util.HashMap;
import java.util.Map;

public class BookmarkExample {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("contract_template.docx");
        
        // 書簽名與替換內(nèi)容的映射
        Map<String, String> bookmarkData = new HashMap<>();
        bookmarkData.put("party_a", "XX科技有限公司");
        bookmarkData.put("party_b", "YY貿(mào)易有限公司");
        bookmarkData.put("contract_date", "2026年4月13日");
        bookmarkData.put("contract_amount", "人民幣伍拾萬(wàn)元整（￥500,000）");
        
        BookmarksNavigator navigator = new BookmarksNavigator(document);
        for (Map.Entry<String, String> entry : bookmarkData.entrySet()) {
            navigator.moveToBookmark(entry.getKey());
            navigator.replaceBookmarkContent(entry.getValue(), true);
        }
        
        document.saveToFile("contract_output.docx", FileFormat.Docx);
        document.dispose();
    }
}

書簽方式適用于合同、證書等需要保留結(jié)構(gòu)并在多處精準(zhǔn)插入內(nèi)容的場(chǎng)景。

功能三：添加批注

在團(tuán)隊(duì)協(xié)作或文檔審閱場(chǎng)景中，批注功能用于對(duì)特定內(nèi)容提出修改建議或補(bǔ)充說(shuō)明。Spire.Doc 支持在指定文本或段落上添加批注：

import com.spire.doc.*;
import com.spire.doc.documents.*;
import com.spire.doc.fields.Comment;
import com.spire.doc.fields.TextRange;

public class AddCommentExample {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("report.docx");
        
        // 查找要批注的文本
        TextSelection find = document.findString("目標(biāo)內(nèi)容", false, true);
        TextRange range = find.getAsOneRange();
        Paragraph para = range.getOwnerParagraph();
        
        // 創(chuàng)建批注對(duì)象
        Comment comment = new Comment(document);
        comment.getBody().addParagraph().setText("此處建議補(bǔ)充數(shù)據(jù)來(lái)源說(shuō)明。");
        comment.getFormat().setAuthor("審核人");
        
        // 將批注添加到段落并設(shè)置標(biāo)記范圍
        para.getChildObjects().add(comment);
        CommentMark startMark = new CommentMark(document, 
                comment.getFormat().getCommentId(), CommentMarkType.Comment_Start);
        CommentMark endMark = new CommentMark(document, 
                comment.getFormat().getCommentId(), CommentMarkType.Comment_End);
        
        int index = para.getChildObjects().indexOf(range);
        para.getChildObjects().insert(index, startMark);
        para.getChildObjects().insert(index + 2, endMark);
        
        document.saveToFile("report_with_comment.docx", FileFormat.Docx);
        document.dispose();
    }
}

如果需要對(duì)整個(gè)段落添加批注，可以使用更簡(jiǎn)潔的 Paragraph.appendComment() 方法。

功能四：文檔格式轉(zhuǎn)換

Word 文檔與其他格式之間的互轉(zhuǎn)是日常開發(fā)中的高頻需求。Spire.Doc 支持多種格式的雙向轉(zhuǎn)換：

Word 轉(zhuǎn) PDF

import com.spire.doc.Document;
import com.spire.doc.FileFormat;

public class WordToPdf {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("report.docx");
        document.saveToFile("report.pdf", FileFormat.PDF);
        document.dispose();
    }
}

Word 與 TXT 互轉(zhuǎn)

// Word 轉(zhuǎn) TXT
Document doc = new Document();
doc.loadFromFile("document.docx");
doc.saveToFile("document.txt", FileFormat.Txt);

// TXT 轉(zhuǎn) Word
Document txtDoc = new Document();
txtDoc.loadFromFile("notes.txt");
txtDoc.saveToFile("notes.docx", FileFormat.Docx);

Word 與 HTML 互轉(zhuǎn)

import com.spire.doc.documents.XHTMLValidationType;

// Word 轉(zhuǎn) HTML
Document doc = new Document();
doc.loadFromFile("article.docx");
doc.saveToFile("article.html", FileFormat.Html);

// HTML 轉(zhuǎn) Word
Document htmlDoc = new Document();
htmlDoc.loadFromFile("content.html", FileFormat.Html, XHTMLValidationType.None);
htmlDoc.saveToFile("content.docx", FileFormat.Docx);

功能五：文檔加密與保護(hù)

對(duì)于涉及敏感信息的文檔，可以通過(guò)加密來(lái)限制訪問(wèn)權(quán)限：

import com.spire.doc.Document;
import com.spire.doc.FileFormat;

public class DocumentProtection {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("confidential.docx");
        
        // 設(shè)置打開密碼
        document.encrypt("open_password");
        
        // 設(shè)置編輯限制密碼（僅允許填寫表單域）
        document.protect(ProtectionType.Allow_Only_Form_Fields, "edit_password");
        
        document.saveToFile("protected.docx", FileFormat.Docx);
        document.dispose();
    }
}

讀取加密文檔時(shí)，在 loadFromFile 方法中傳入密碼即可：

Document document = new Document();
document.loadFromFile("protected.docx", FileFormat.Docx, "open_password");

兩種模板處理方式的對(duì)比

在動(dòng)態(tài)生成文檔的場(chǎng)景中，文本替換和書簽替換是兩種常用方式，各有適用場(chǎng)景：

對(duì)比維度	文本占位符替換	書簽替換
實(shí)現(xiàn)復(fù)雜度	簡(jiǎn)單，僅需定義占位符格式	稍復(fù)雜，需預(yù)先在模板中插入書簽
定位精度	可能誤替換正文中的相同文本	精準(zhǔn)定位，不會(huì)誤操作
可重復(fù)編輯	替換后占位符消失	替換后書簽仍保留
圖片插入	需單獨(dú)處理圖片替換邏輯	可配合其他 API 實(shí)現(xiàn)
適用場(chǎng)景	簡(jiǎn)單報(bào)告、信函等輕量模板	結(jié)構(gòu)復(fù)雜的合同、證書等