快捷導(dǎo)航

Java實現(xiàn)根據(jù)模板高效生成Word文檔

更新時間：2026年03月10日 08:29:11 作者：SunnyDays1011

在日常辦公中,我們經(jīng)常需要生成標(biāo)準(zhǔn)化的Word文檔,手工填充內(nèi)容不僅繁瑣,而且容易出錯,下面小編就和大家詳細講講如何使用Java根據(jù)模板生成Word文檔吧

在日常辦公、報表生成或者文檔自動化處理中，我們經(jīng)常需要生成標(biāo)準(zhǔn)化的Word文檔。手工填充內(nèi)容不僅繁瑣，而且容易出錯。使用Java根據(jù)模板生成Word文檔，可以大幅提升效率和準(zhǔn)確性。本文將重點介紹兩種常用方法：

通過替換文本占位符生成Word文檔
通過修改書簽內(nèi)容生成Word文檔

這兩種方法各有優(yōu)勢，選擇合適的方法可以讓文檔生成更穩(wěn)定、高效。

為什么選擇模板生成Word文檔

在很多企業(yè)應(yīng)用場景中，例如合同生成、發(fā)票填充、報告自動化等，Word模板是標(biāo)準(zhǔn)化內(nèi)容輸出的核心。使用模板可以確保：

文檔結(jié)構(gòu)統(tǒng)一
樣式一致（字體、段落、頁眉頁腳）
數(shù)據(jù)替換靈活
支持批量生成

相比直接寫入Word文檔內(nèi)容，模板方式更安全、更高效，也更便于維護。

Java操作Word文檔庫安裝說明

要在Java中操作Word文檔，可以使用第三方庫，例如 Spire.Doc for Java 或 Apache POI。本文示例使用 Spire.Doc for Java，因為它對模板、占位符和書簽操作都很方便。

1. Maven依賴

在pom.xml中添加以下依賴（以Spire.Doc為例）：

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

2. 手動下載Jar包

如果不使用Maven，也可以：

前往 Spire.Doc for Java官網(wǎng) 下載Jar包
將Jar包添加到項目的 lib 目錄
配置IDE（如IntelliJ IDEA或Eclipse）導(dǎo)入Jar包

注意：Spire.Doc提供免費版和商業(yè)版，免費版有頁數(shù)限制，商業(yè)版可完全生成Word文檔。

3. 驗證安裝

創(chuàng)建一個簡單的Java程序讀取模板文檔，確保沒有編譯錯誤即可。

import com.spire.doc.Document;

public class TestSpireDoc {
    public static void main(String[] args) {
        Document doc = new Document();
        System.out.println("Spire.Doc庫加載成功！");
    }
}

安裝和配置完成后，即可繼續(xù)下面的方法示例。

方法一：通過文本占位符替換生成Word文檔

原理簡介

文本占位符通常是模板中用特定符號標(biāo)識的變量，例如 #name#、#date#。Java程序讀取模板文檔后，通過查找占位符并替換為實際數(shù)據(jù)，生成最終Word文檔。占位符還可以用于文本和圖片，方便快速生成標(biāo)準(zhǔn)化文檔。

優(yōu)勢

簡單直觀，易于上手
批量生成文檔效率高
占位符可靈活擴展

實現(xiàn)步驟

1.準(zhǔn)備模板

在Word模板中定義占位符，例如：

姓名：#name#
性別：#gender#
出生日期：#birthdate#
地址：#address#
城市：#city#
省份：#province#
郵編：#postal#
國家：#country#
照片：#photo#

2.讀取模板文檔：使用Spire.Doc庫讀取模板文件。

3.替換占位符文本與圖片：遍歷模板中的占位符，將其替換為實際內(nèi)容或圖片。

4.保存生成文檔：輸出為新的Word文件，供用戶下載或打印。

代碼示例

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

import java.util.HashMap;
import java.util.Map;

public class ReplaceTextPlaceholders {

    public static void main(String[] args) {

        Document document = new Document();
        document.loadFromFile("C:\\Users\\Administrator\\Desktop\\template.docx");

        Map<String, String> replaceDict = new HashMap<>();
        replaceDict.put("#name#", "約翰");
        replaceDict.put("#gender#", "男");
        replaceDict.put("#birthdate#", "1990年1月15日");
        replaceDict.put("#address#", "緬因街123號");
        replaceDict.put("#city#", "斯普林菲爾德");
        replaceDict.put("#province#", "伊利諾伊州");
        replaceDict.put("#postal#", "62701");
        replaceDict.put("#country#", "美國");

        for (Map.Entry<String, String> entry : replaceDict.entrySet()) {
            document.replace(entry.getKey(), entry.getValue(), true, true);
        }

        String imagePath = "C:\\Users\\Administrator\\Desktop\\portrait.png";
        replaceTextWithImage(document, "#photo#", imagePath);

        document.saveToFile("output/ReplacePlaceholders.docx", FileFormat.Docx);
        document.dispose();

        System.out.println("文檔生成成功！");
    }

    static void replaceTextWithImage(Document document, String placeholder, String imagePath) {
        DocPicture pic = new DocPicture(document);
        pic.loadImage(imagePath);
        pic.setScale(80f);

        TextSelection selection = document.findString(placeholder, false, true);
        if (selection != null) {
            TextRange range = selection.getAsOneRange();
            int index = range.getOwnerParagraph().getChildObjects().indexOf(range);
            range.getOwnerParagraph().getChildObjects().insert(index, pic);
            range.getOwnerParagraph().getChildObjects().remove(range);
        }
    }
}

注意事項

占位符命名應(yīng)有規(guī)律，避免與正常文本沖突
如果模板內(nèi)容復(fù)雜（表格、頁眉頁腳），需確保遍歷所有段落和表格單元格
圖片占位符需要設(shè)置縮放比例，防止影響排版

生成結(jié)果：

方法二：通過書簽修改生成Word文檔

原理簡介

書簽是Word文檔自帶的標(biāo)記位置，可以在文檔中固定一個位置，用于后續(xù)程序插入或修改內(nèi)容。書簽方式更適合復(fù)雜文檔結(jié)構(gòu)，例如表格、圖表或多段落內(nèi)容的插入。

優(yōu)勢

支持在任意位置精確插入內(nèi)容
適合復(fù)雜文檔（表格、圖表）
避免占位符與普通文本沖突

實現(xiàn)步驟

在模板中創(chuàng)建書簽：在Word中選中內(nèi)容位置，插入書簽，例如：name、year、headquarter。
讀取模板文檔：使用Spire.Doc庫加載模板文件。
定位書簽并修改內(nèi)容：遍歷書簽并替換為實際文本內(nèi)容。
保存生成文檔：輸出最終Word文件。

import com.spire.doc.*;
import com.spire.doc.documents.*;
import java.util.HashMap;
import java.util.Map;

public class ModifyBookmarkContent {

    public static void main(String[] args) {

        Document document = new Document();
        document.loadFromFile("C:\\Users\\Administrator\\Desktop\\template.docx");

        Map<String, String> replaceDict = new HashMap<>();
        replaceDict.put("name", "Tech Innovations Inc.");
        replaceDict.put("year", "2015");
        replaceDict.put("headquarter", "美國，加州，舊金山");
        replaceDict.put("history", "Tech Innovations Inc. 由一群懷抱夢想的工程師和創(chuàng)業(yè)者共同創(chuàng)立，" +
                "他們立志在科技領(lǐng)域掀起一場革命。公司最初專注于軟件開發(fā)，隨后逐步將業(yè)務(wù)版圖擴展至人工智能和云計算解決方案領(lǐng)域。");

        BookmarksNavigator bookmarkNavigator = new BookmarksNavigator(document);
        for (Map.Entry<String, String> entry : replaceDict.entrySet()) {
            bookmarkNavigator.moveToBookmark(entry.getKey());
            bookmarkNavigator.replaceBookmarkContent(entry.getValue(), true);
        }

        document.saveToFile("output/ReplaceBookmarkContent.docx", FileFormat.Docx);
        document.dispose();

        System.out.println("書簽內(nèi)容替換完成！");
    }
}

注意事項

書簽名唯一，避免重復(fù)
替換內(nèi)容長度過長時，可能影響文檔排版，需要測試調(diào)整
可以和文本占位符方式結(jié)合，實現(xiàn)復(fù)雜文檔生成

生成結(jié)果：

方法對比

方法	優(yōu)勢	適用場景
文本占位符	簡單、快速	批量生成合同、通知類文檔
書簽	精準(zhǔn)、適合復(fù)雜內(nèi)容	表格、圖片或多段落插入場景