Java操作Word教程：Apache POI详解

Apache POI 是 Java 操作 Word 文档的常用工具，支持 .doc 和 .docx 格式。1. 读取内容：对 .doc 使用 HWPFDocument，对 .docx 使用 XWPFDocument 遍历段落获取文本。2. 写入内容：通过 XWPFDocument 创建段落和运行实例，设置文本并保存文件，可设置字体样式。3. 替换模板变量：遍历段落和运行实例，查找并替换占位符如 ${name}。4. 插入表格和图片：使用 XWPFTable 添加表格内容，通过 addPictureData 和 addPicture 插入图片，单位需转换为 EMU。注意资源释放、版本差异及复杂结构处理。

用Java操作Word文档，最常用的工具之一就是 Apache POI。它支持读写 Microsoft Office 格式文件，包括 Word（.doc 和 .docx）。虽然处理 Word 的功能不如 Excel 强大，但日常需求基本都能满足。

下面介绍几个常见的使用场景和操作方法，适合刚上手的开发者。

读取 Word 文档内容

如果你只是想从一个 .doc 或 .docx 文件中提取文字内容，POI 提供了比较直接的方式。

对于 .doc 文件（Office 2003 及以前）：

FileInputStream fis = new FileInputStream("test.doc");
HWPFDocument doc = new HWPFDocument(fis);
String text = doc.getDocumentText();
System.out.println(text);

对于 .docx 文件（Office 2007+）：

XWPFDocument document = new XWPFDocument(new FileInputStream("test.docx"));
for (XWPFParagraph paragraph : document.getParagraphs()) {
    System.out.println(paragraph.getText());
}

注意：如果文档结构复杂，比如包含表格、图片等，就需要遍历段落的同时判断不同元素类型来分别处理。

向 Word 中写入内容

创建一个新的 Word 文档并写入文本也很简单。

生成 .docx 文件示例：

XWPFDocument document = new XWPFDocument();

// 添加一段文字
XWPFParagraph paragraph = document.createParagraph();
XWPFRun run = paragraph.createRun();
run.setText("这是一个新文档的内容");

// 保存到文件
try (FileOutputStream out = new FileOutputStream("output.docx")) {
    document.write(out);
}

你还可以设置字体、加粗、颜色等格式，只需要在 XWPFRun 上调用相应方法即可。

常见问题注意点：

• 不同版本 POI 的 API 可能略有差异，建议查看对应版本文档。
• 写入后务必关闭流或 try-with-resources，避免资源泄露。
• 如果要覆盖已有文档内容，需要先加载再修改。

替换 Word 模板中的占位符

实际开发中，经常使用 Word 模板替换变量，比如“${name}”替换成具体值。

实现思路是遍历所有段落和表格单元格，查找特定标记并替换：

for (XWPFParagraph para : document.getParagraphs()) {
    for (XWPFRun run : para.getRuns()) {
        String text = run.getText(0);
        if (text != null && text.contains("${name}")) {
            text = text.replace("${name}", "张三");
            run.setText(text, 0);
        }
    }
}

这种方式适用于简单的变量替换。如果是复杂的模板填充，可能还需要结合表格、列表甚至图片插入。

插入表格和图片

除了纯文本，POI 也支持插入表格和图片。

插入表格：

XWPFTable table = document.createTable(2, 2);
table.getRow(0).getCell(0).setText("第一行第一列");
table.getRow(0).getCell(1).setText("第一行第二列");

插入图片：

FileInputStream imageStream = new FileInputStream("logo.png");
int format = XWPFDocument.PICTURE_TYPE_PNG;
String blipId = document.addPictureData(imageStream, format);
XWPFRun run = paragraph.createRun();
run.addPicture(blipId, format, "logo.png", Units.toEMU(200), Units.toEMU(100));

注意：插入图片时单位要用 EMU（English Metric Unit），Apache POI 提供了 Units 工具类转换像素。

以上就是使用 Apache POI 操作 Word 的一些基础用法。虽然不像操作 Excel 那样灵活，但对于大多数业务场景已经足够用了。

基本上就这些，不复杂但容易忽略细节的地方在于格式兼容性、资源释放和复杂结构处理。遇到具体问题可以多查官方示例或者 Stack Overflow。