Java实现Word文档表格生成的完整指南

在Java企业应用中，动态生成Word文档是一项常见需求，尤其是包含表格的报表、合同或清单。本文将深入探讨如何使用Java生成带表格的Word文档，涵盖两种主流库：Apache POI 和 docx4j，并对比它们的特点与适用场景。

一、为什么需要Java生成Word表格？

手动创建Word文档费时费力，且容易出错。通过Java自动化生成，可以实现：

• 批量生成个性化报告（如月度销售表）
• 动态填充数据库数据到表格
• 统一文档格式与样式

二、Apache POI 方案

2.1 环境准备

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.3</version>
</dependency>

2.2 创建简单表格

XWPFDocument doc = new XWPFDocument();
XWPFTable table = doc.createTable(3, 4); // 3行4列
// 填充数据
for (int row = 0; row < 3; row++) {
    for (int col = 0; col < 4; col++) {
        table.getRow(row).getCell(col).setText("Cell " + row + "," + col);
    }
}
doc.write(new FileOutputStream("simple_table.docx"));

2.3 样式控制

POI支持合并单元格、设置宽度、边框等。例如合并第一行所有列：

table.getRow(0).getCell(0).getCTTc().addNewTcPr().addNewHMerge().setVal(STMerge.RESTART);
for (int i = 1; i < 4; i++) {
    table.getRow(0).getCell(i).getCTTc().addNewTcPr().addNewHMerge().setVal(STMerge.CONTINUE);
}

三、docx4j 方案

3.1 引入依赖

<dependency>
    <groupId>org.docx4j</groupId>
    <artifactId>docx4j-JAXB-MOXy</artifactId>
    <version>8.3.9</version>
</dependency>

3.2 创建表格

WordprocessingMLPackage wordMLPackage = WordprocessingMLPackage.createPackage();
// 创建2行3列表格
Tbl table = new Tbl();
for (int i = 0; i < 2; i++) {
    Tr row = new Tr();
    for (int j = 0; j < 3; j++) {
        Tc cell = new Tc();
        cell.getContent().add(wordMLPackage.getMainDocumentPart().createParagraphOfText("Data " + i + "," + j));
        row.getContent().add(cell);
    }
    table.getContent().add(row);
}
wordMLPackage.getMainDocumentPart().addObject(table);
wordMLPackage.save(new File("docx4j_table.docx"));

四、方案对比与选择

推荐：若需要快速上手且表格不复杂，选POI；若需要精细控制或转换HTML到Word，选docx4j。

五、高级技巧：从数据库动态填充

List<User> users = userDao.getAll();
XWPFTable table = doc.createTable(users.size() + 1, 4);
// 表头
table.getRow(0).getCell(0).setText("ID");
table.getRow(0).getCell(1).setText("Name");
table.getRow(0).getCell(2).setText("Email");
table.getRow(0).getCell(3).setText("Created");
// 数据行
for (int i = 0; i < users.size(); i++) {
    User u = users.get(i);
    table.getRow(i + 1).getCell(0).setText(String.valueOf(u.getId()));
    table.getRow(i + 1).getCell(1).setText(u.getName());
    // ...
}

六、常见问题与解决方案

• 表格列宽不一致：使用CTTblWidth设置列宽，单位是缇（1英寸=1440缇）。
• 单元格垂直对齐：POI需设置CTShd和CTVerticalJc；docx4j通过TcPr的vAlign属性。
• 图片嵌入表格：POI使用run.addPicture()添加到单元格；docx4j通过BinaryPartAbstractImage。

七、总结

Java生成Word表格并不复杂，选择合适的库可以事半功倍。本文的示例代码覆盖了基础创建、样式调整和动态数据填充，你可以在此基础上扩展出满足业务需求的自动化文档系统。记住，实践出真知，动手尝试吧！

（如果需要完整可运行示例，请访问我的GitHub仓库。）