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 提供了比较直接的方式。
立即学习“Java免费学习笔记（深入）”；
对于 .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 工具类转换像素。
