Java操作Word文档全面指南

一、开源解决方案

1. Apache POI

Apache POI 是最广泛使用的开源 Office 操作库之一，提供对 .doc 与 .docx 格式的支持。

核心特点：

使用 XWPF 操作 .docx，HWPF 操作 .doc；
支持段落、表格、样式、图片等常用操作。

代码示例：

XWPFDocument document = new XWPFDocument();
XWPFParagraph paragraph = document.createParagraph();
XWPFRun run = paragraph.createRun();
run.setText("Hello, World!");
run.setBold(true);
try (FileOutputStream out = new FileOutputStream("example.docx")) {
document.write(out);
}
document.close();

优缺点汇总：

✅ 同时支持 .doc 和 .docx
✅ 社区活跃，文档齐全
❌ 大文档处理性能较差
❌ 样式、页眉页脚等复杂功能不够灵活

2. docx4j

docx4j 是一个专注于 Open XML（.docx）格式的文档处理库，内部基于 JAXB，适合精细结构化文档控制。

代码示例：

WordprocessingMLPackage wordPackage = WordprocessingMLPackage.createPackage();
wordPackage.getMainDocumentPart().addParagraphOfText("Hello World!");
wordPackage.save(new File("output.docx"));

优缺点汇总：

✅ XML结构支持更强，适合精准控制文档结构
✅ 支持MathML、嵌套样式等高级功能
❌ 不支持 .doc 格式
❌ 学习曲线略高，开发初期调试成本大

3. JasperReports

JasperReports 本质是报表工具，但通过模板 + 数据源 + 导出器，也可以生成 Word 文档。

代码示例：

JasperReport report = JasperCompileManager.compileReport("report.jrxml");
JasperPrint print = JasperFillManager.fillReport(report, params, dataSource);
JasperExportManager.exportReportToDocxFile(print, "output.docx");

适用场景： 报表、发票、合同批量生成

优缺点汇总：

✅ 报表设计器可视化设计（iReport、Jaspersoft Studio）
✅ 模板强大，适合动态数据绑定
❌ 对Word原生格式支持不深，格式兼容性不稳定
❌ 适合报表而非复杂排版文档

4. LibreOffice / OpenOffice UNO API

通过 Java UNO 接口调用 LibreOffice 实现文档读写、格式转换（PDF、HTML等）。

代码示例：

XComponentContext context = Bootstrap.bootstrap();
XComponentLoader loader = Lo.loadOffice(context);
XComponent document = Lo.loadDocument(loader, "doc.docx");
XTextDocument textDoc = Lo.qi(XTextDocument.class, document);
textDoc.getText().insertString(textDoc.getText().createTextCursor(), "New text", false);
Lo.saveDocument(document, new File("output.docx"));

优缺点汇总：

✅ 支持所有Office格式，功能全面
✅ 可导出 PDF、HTML 等格式
❌ 需要安装本地 LibreOffice
❌ 性能差，不适合并发或云部署

5. Poi-tl

Poi-tl 是基于 Apache POI 的模板引擎，专注于模板 + 数据填充，适合非结构化文档输出（如合同、证书等）。

代码示例：

XWPFTemplate template = XWPFTemplate.compile("template.docx")
.render(Map.of("name", "张三", "date", "2025-06-01"));
template.writeAndClose(new FileOutputStream("output.docx"));

优缺点汇总：

✅ 模板简单灵活（Word中用 {{变量}} 占位）
✅ 支持图片、循环、表格行动态渲染
❌ 对复杂逻辑（条件判断）支持有限
❌ 渲染能力受限于 POI 本身的性能瓶颈

6. JWord（FreeMarker 模板渲染）

通过 FreeMarker 渲染 .xml 格式的 Word 模板（docx本质为zip+xml结构）。

代码示例：

Configuration cfg = new Configuration(Configuration.VERSION_2_3_31);
Template template = cfg.getTemplate("template.xml");
try (Writer out = new FileWriter("output.xml")) {
template.process(dataModel, out);
}

然后手动或程序自动打包为 .docx。

优缺点汇总：

✅ 模板高度可控
✅ 支持复杂逻辑（if、for等）
❌ 模板设计复杂，需要了解Word XML结构
❌ 对普通开发者学习门槛高

二、商业解决方案

7. Aspose.Words for Java

Aspose.Words 是功能最全、性能最强的商业库之一，支持几乎所有Word相关操作和转换。

代码示例：

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.writeln("Hello, Aspose!");
doc.save("output.docx");

核心优势：

支持 .doc, .docx, .pdf, .html, .txt 等多格式读写
支持邮件合并、书签、批注、页眉页脚、字体嵌入、图表等高级功能
高性能流式处理，适合海量文档生成

缺点：

❌ 商业授权费用高（年费制）
❌ JAR包体积较大，首次启动慢

8. Google Docs API

用于操作 Google Docs 云端文档，适合协同编辑场景。

代码示例：

Document doc = new Document().setTitle("Java生成");
docs.documents().create(doc).execute();

优缺点汇总：

✅ 云端访问，无需安装环境
✅ 可实时协作、审阅、评论
❌ 受限于Google服务，网络环境依赖大
❌ 不支持本地 .doc/.docx 文件的结构化编辑

三、方案对比表格

方案	类型	格式支持	性能	易用性	模板支持	推荐场景
Apache POI	开源	doc/docx	中	中	❌	通用Word读写
docx4j	开源	docx	中	中	❌	精细结构控制
JasperReports	开源	多格式	高	低	✅	报表、合同、发票
LibreOffice API	开源	多格式	低	低	❌	格式转换、大纲编辑
Poi-tl	开源	docx	中	高	✅	合同、证书模板填充
JWord (FreeMarker)	开源	docx (xml)	高	中	✅	灵活结构控制
Aspose.Words	商业	全格式	高	高	✅	企业级、复杂排版
Google Docs API	云端	docx (云端)	中	中	❌	协同文档生成