Java 基于模板生成 Word 文档

在现代软件开发中，从模板生成动态 Word 文档是生成报告、合同、发票或其他业务文档的常见需求。寻求文档自动化高效解决方案的 Java 开发者可以利用 Spire.Doc for Java，这是一个无需安装 Microsoft Office 即可处理 Word 文件的强大库。

本指南将探讨如何使用 Spire.Doc for Java 从 模板创建 Word 文档，涵盖两种关键方法：替换文本占位符和修改书签内容。

用于创建 Word 文档的 Java库
通过替换文本占位符生成 Word 文档
通过修改书签内容生成 Word 文档
结论
常见问题解答

用于创建 Word 文档的 Java 库

Spire.Doc for Java 是一个功能强大的库，支持开发者创建、操作和转换 Word 文档。它提供了直观的 API，可对现有文档中的文本、图片和书签等进行各种操作。

首先，请从我们的官网下载该库并导入到 Java 项目中。如果使用 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.5.3</version>
    </dependency>
</dependencies>

通过替换文本占位符生成 Word 文档

该方法使用包含标记占位符（如 #name#、#date#）的模板文档，这些占位符会被动态替换为真实数据。Spire.Doc 的 Document.replace() 方法可高效处理文本替换，同时其他 API 支持高级替换功能（例如在指定位置插入图片）。

通过替换文本占位符从模板生成 Word 文档的步骤：

初始化文档：创建 Document 对象以操作 Word 文件。
加载模板：载入包含占位符的模板文档。
创建替换映射：用 HashMap 存储占位符与替换内容的键值对。
执行文本替换：通过 replace() 方法查找并替换所有占位符实例。
处理图片插入：使用自定义 replaceTextWithImage() 方法将文本占位符替换为图片。
保存结果：将修改后的文档保存至指定路径。

Java

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 document = new Document();

        // 加载模板文档
        document.loadFromFile("C:\\Users\\Administrator\\Desktop\\template.docx");

        // 创建HashMap用于保存占位符及其替换内容
        Map 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 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();
    }

    // 方法用于用图像替换文档中的占位符
    static void replaceTextWithImage(Document document, String stringToReplace, String imagePath) {

        // 从指定路径加载图像
        DocPicture pic = new DocPicture(document);
        pic.loadImage(imagePath);
        pic.setScale(80f);

        // 在文档中查找占位符
        TextSelection selection = document.findString(stringToReplace, false, true);

        //  获取找到的文本范围
        TextRange range = selection.getAsOneRange();
        int index = range.getOwnerParagraph().getChildObjects().indexOf(range);

        // 插入图像并移除占位符文本
        range.getOwnerParagraph().getChildObjects().insert(index, pic);
        range.getOwnerParagraph().getChildObjects().remove(range);
    }
}

效果图：

通过替换文本占位符生成Word文档

通过修改书签内容生成 Word 文档

该方法利用 Word 文档中的书签来标识需要插入或修改内容的位置。Spire.Doc 提供的 BookmarksNavigator 类简化了这一流程，可直接定位书签位置进行精准内容替换，同时自动保留文档原有的结构和格式。

通过修改书签内容从模板生成Word文档的步骤：

初始化文档：创建 Document 对象。
加载模板：载入已预设书签的模板文档。
配置替换内容：创建 HashMap 建立书签名称与替换内容的映射关系。
定位书签：实例化 BookmarksNavigator 对象遍历文档中的书签。
替换内容：调用 replaceBookmarkContent() 方法更新书签内容
保存结果：将修改后的文档输出至指定路径。

Java

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 document = new Document();

        // 加载模板文档
        document.loadFromFile("C:\\Users\\Administrator\\Desktop\\template.docx");

        // 定义书签名称及对应的用于替换的文本
        Map replaceDict = new HashMap<>();
        replaceDict.put("name", "Tech Innovations Inc.");
        replaceDict.put("year", "2015");
        replaceDict.put("headquarter", "美国，加州，旧金山");
        replaceDict.put("history", "Tech Innovations Inc. 由一群怀抱梦想的工程师和创业者共同创立，" +
                "他们立志在科技领域掀起一场革命。公司最初专注于软件开发，随后逐步将业务版图扩展至人工智能和云计算解决方案领域。");

        // 创建BookmarksNavigator对象用于管理文档中的书签
        BookmarksNavigator bookmarkNavigator = new BookmarksNavigator(document);

        // 遍历HashMap中的条目
        for (Map.Entry entry : replaceDict.entrySet()) {

            // 定位到具体书签
            bookmarkNavigator.moveToBookmark(entry.getKey());

            // 替换书签内容
            bookmarkNavigator.replaceBookmarkContent(entry.getValue(), true);
        }

        // 保存修改后的文档
        document.saveToFile("output/ReplaceBookmarkContent.docx", FileFormat.Docx);

        // 释放资源
        document.dispose();
    }
}

效果图：

通过替换书签内容生成Word文档

结论

两种方法都能有效实现模板化文档生成，但适用于不同场景：

文本替换法适用于以下情况：

需要进行简单文本替换
需在指定位置插入图片
需替换文档任意位置的文本（不限于特定区域）

书签替换法更适合以下需求：

处理结构复杂的文档（需精确定位内容位置）
需要替换大段内容或完整段落
需保留书签以便后续更新

Spire.Doc 还提供邮件合并功能（Mail Merge），支持从数据库等外部数据源批量生成个性化文档（如群发信函/报告）。该功能通过将模板字段与外部数据关联，可高效完成大批量文档自动化生成。

常见问题解答

Q1：能否将生成的 Word 文档转换为 PDF 格式？

A：可以。Spire.Doc for Java 支持将文档转换为 PDF 等多种格式，只需使用 saveToFile() 方法并指定 FileFormat.PDF 参数即可。

Q2：如何保持生成文档的复杂格式？

A：建议先在Word模板中设置好所有需要的格式，然后在需要插入动态内容的位置使用占位符或书签。生成文档时，这些标记周围的格式会自动保留。

Q3：邮件合并和文本替换有什么区别？

A：邮件合并专为将数据库类数据与文档合并而设计，支持记录重复节等高级功能；而文本替换更简单，但对表格数据的处理不如邮件合并灵活。

申请临时License

如果您需要去除生成文档中的评估提示或解除功能限制，请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。