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 上调用相应方法即可。
常见问题注意点：
从一个Perl爱好者到一个Perl程序员。《Intermediate Perl》将教您如何把Perl作为编程语言来使用，而不仅只是作为一种脚本语言。 Perl是一种灵活多变、功能强大的编程语言，可以应用在从系统管理到网络编程再到数据库操作等很多方面。人们常说Perl让容易的事情变简单、让困难的事情变得可行。《Intermediate Perl》正是关于如何将技能从处理简单任务跃升到胜任困难任务的书籍。 本书提供对Perl中级编程优雅而仔细的介绍。由畅销的《学习Perl》作者所著，本书提供了《学习P
- 不同版本 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。
