本文詳細講解如何使用 Java 動態導出包含多人員報名表的 Word 文檔，每人占據獨立一頁，并支持動態表格行（如個人經歷）。我們對比了多種實現方案，最終推薦基于 Freemarker + XML 模板 或 docx4j 的靈活方式，并提供完整代碼示例與最佳實踐，助你高效實現復雜 Word 導出需求。
一、需求分析
在許多業務場景中（如招聘報名、活動登記、培訓考核等），我們需要將多人的信息導出為 Word 文檔，通常要求：
- 每人一頁：每個人的報名表獨立成頁，便于打印或分發；
- 動態表格行：如“工作經歷”“學習經歷”等，每個人的條目數量不固定；
- 模板可配置：希望報名表的字段、排版可靈活調整，而非硬編碼；
- 導出為標準 DOCX：兼容 Microsoft Word，支持分頁、表格樣式等。
傳統方式（如直接拼接字符串生成 Word）難以滿足動態需求，而 Apache POI 雖然功能強大，但 API 繁瑣。本文將介紹更優雅的解決方案。
二、實現思路
方案對比
| 方案 | 技術棧 | 靈活性 | 復雜度 | 適用場景 |
|---|---|---|---|---|
| Freemarker + XML 模板 | Freemarker + 手動操作 DOCX 結構 | ???? | 中高 | 需要高度定制化模板 |
| docx4j | docx4j 庫 | ????? | 中 | 生產環境推薦，支持復雜排版 |
| Apache POI XWPF | Apache POI | ??? | 中高 | 簡單到中等復雜度需求 |
| JasperReports | JasperReports | ?? | 低 | 報表類導出 |
推薦選擇：
- 追求靈活性和可控性 → Freemarker + XML 模板
- 追求開發效率和穩定性 → docx4j
核心實現步驟
- 定義數據模型：如
Applicant（姓名、經歷等）； - 準備 Word 模板：
- 方式 1：從 DOCX 中提取
document.xml，用 Freemarker 語法替換動態部分； - 方式 2：直接編寫 XML 模板（需熟悉 Word 的 XML 結構）；
- 方式 1：從 DOCX 中提取
- 動態渲染：用 Freemarker 填充數據，生成
document.xml； - 打包為 DOCX：將渲染后的 XML 放入標準 DOCX 結構（或使用 docx4j 直接生成）。
三、示例代碼
1. 數據模型定義
// Applicant.java
public class Applicant {private String name;private List<Experience> experiences;// getters/setters...
}// Experience.java
public class Experience {private String period;private String organization;// getters/setters...
}
2. Freemarker + XML 模板方案
（1）XML 模板片段（applicant_template.ftl）
<w:tbl><w:tr><w:tc<w:p><w:r><w:t>時間段</w:t></w:r></w:p></w:tc><w:tc<w:p><w:r><w:t>單位</w:t></w:r></w:p></w:tc></w:tr><#list experiences as exp><w:tr><w:tc<w:p><w:r><w:t>${exp.period}</w:t></w:r></w:p></w:tc><w:tc<w:p><w:r><w:t>${exp.organization}</w:t></w:r></w:p></w:tc></w:tr></#list>
</w:tbl>
<w:p<w:r><w:br w:type="page"/></w:r></w:p> <!-- 分頁符 -->
（2）Java 渲染代碼
Configuration cfg = new Configuration(Configuration.VERSION_2_3_31);
cfg.setClassForTemplateLoading(getClass(), "/templates");
Template template = cfg.getTemplate("applicant_template.ftl");StringWriter xmlWriter = new StringWriter();
Map<String, Object> data = new HashMap<>();
data.put("name", applicant.getName());
data.put("experiences", applicant.getExperiences());
template.process(data, xmlWriter);// 將 xmlWriter.toString() 插入到完整 DOCX 的 document.xml 中
3. docx4j 方案（推薦生產環境使用）
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
import org.docx4j.wml.*;// 創建 Word 文檔
WordprocessingMLPackage wordMLPackage = WordprocessingMLPackage.createPackage();// 循環添加每個人
for (Applicant applicant : applicants) {// 添加基本信息段落wordMLPackage.getMainDocumentPart().addParagraphOfText("姓名: " + applicant.getName());// 創建表格Tbl table = factory.createTbl();// 添加表頭行...// 循環添加經歷行...wordMLPackage.getMainDocumentPart().addObject(table);// 添加分頁符wordMLPackage.getMainDocumentPart().addPageBreak();
}// 保存為 DOCX
wordMLPackage.save(new File("applicants.docx"));
四、優勢對比
| 方案 | 優點 | 缺點 |
|---|---|---|
| Freemarker + XML | 完全控制模板，適合復雜需求 | 需手動處理 DOCX 結構 |
| docx4j | 開箱即用，支持高級功能 | 學習曲線略陡 |
| Apache POI | 無需額外依賴 | API 繁瑣，動態表格難實現 |
最終建議：
- 中小項目或快速原型 → Freemarker + XML
- 企業級應用 → docx4j
五、總結
本文介紹了 Java 動態導出 Word 報名表的完整方案，重點解決了 多人員分頁 和 動態表格行 的需求。通過對比不同技術棧，推薦：
- 靈活性優先 → Freemarker + XML 模板；
- 開發效率優先 → docx4j 庫。
