Java使用POI生成Word模板文件

在企业级Java开发中，经常需要根据模板动态生成Word文档（如合同、报告、通知等）。Apache POI 是一个强大的开源库，支持读写 Microsoft Office 格式文件，包括 Word（.doc 和 .docx）。

什么是 Apache POI？

Apache POI 是 Apache 软件基金会提供的 Java API，用于处理 Microsoft Office 文档。其中：

• XWPF 用于处理 .docx（Office Open XML）格式
• HWPF 用于处理旧版 .doc 格式（已不推荐使用）

基本使用步骤

1. 准备一个 Word 模板（.docx），在需要替换的位置使用占位符，例如 ${name}、${date}
2. 使用 Java 读取该模板文件
3. 遍历文档中的段落和表格，查找并替换占位符
4. 将修改后的文档输出为新的 .docx 文件

示例代码

import org.apache.poi.xwpf.usermodel.*;
import java.io.*;
import java.util.Map;
import java.util.HashMap;

public class WordTemplateGenerator {
    public static void main(String[] args) throws Exception {
        // 1. 加载模板
        InputStream is = new FileInputStream("template.docx");
        XWPFDocument doc = new XWPFDocument(is);

        // 2. 准备数据
        Map<String, String> data = new HashMap<>();
        data.put("${name}", "张三");
        data.put("${date}", "2025-11-13");

        // 3. 替换段落中的文本
        for (XWPFParagraph paragraph : doc.getParagraphs()) {
            replaceInParagraph(paragraph, data);
        }

        // 4. 替换表格中的文本（如有）
        for (XWPFTable table : doc.getTables()) {
            for (XWPFTableRow row : table.getRows()) {
                for (XWPFTableCell cell : row.getCells()) {
                    for (XWPFParagraph paragraph : cell.getParagraphs()) {
                        replaceInParagraph(paragraph, data);
                    }
                }
            }
        }

        // 5. 输出新文件
        FileOutputStream out = new FileOutputStream("output.docx");
        doc.write(out);
        out.close();
        doc.close();
        is.close();
    }

    private static void replaceInParagraph(XWPFParagraph paragraph, Map<String, String> data) {
        for (XWPFRun run : paragraph.getRuns()) {
            String text = run.getText(0);
            if (text != null) {
                for (Map.Entry<String, String> entry : data.entrySet()) {
                    text = text.replace(entry.getKey(), entry.getValue());
                }
                run.setText(text, 0);
            }
        }
    }
}

注意事项

• 占位符应避免被 Word 自动分段（建议整个占位符放在一个“运行”run 中）
• 复杂模板建议使用表格或书签定位
• POI 对 .docx 支持较好，推荐使用 .docx 格式
• 需添加 Maven 依赖：org.apache.poi:poi-ooxml

相关工具推荐

除了编程生成，您也可以使用以下在线工具辅助处理 Word 文档：

• Word转Excel工具
• 在线Word文档编辑