在日常构建中，我们经常需要动态生成 Word 文档，如合同、报表、通知书等。这些文档往往有固定模板，只需要替换其中的特定内容。应用 "标签"（Tag）作为占位符是实现这一需求的高效方式。本文将深入探讨如何使用 Java 操作 Word 文档中的标签并赋值，涵盖主流达成方案、核心原理及实战技巧。
一、Word 标签的本质与应用场景
1.1 什么是 Word 标签？
Word 标签是文档中预先定义的占位符，通常以特定格式标识（如${name}、{ {age}}或 Word 内置的 Content Control 控件），用于后续通过程序动态替换为实际内容。
1.2 常见应用场景
- 合同自动生成（替换甲方、乙方、金额等信息）
- 报表数据填充（动态插入统计数据）
- 批量生成个性化文档（如录取通知书、成绩单）
- 模板化文档处理（固定格式 + 动态内容）
二、Java 操作 Word 的主流库对比
目前 Java 生态中处理 Word 文档的主流库有以下几种，各有优劣：
| 库名称 | 特点 | 适用场景 | 许可证 |
|---|---|---|---|
| Apache POI | 开源免费，支持 OLE2 格式（.doc）和 OOXML（.docx） | 轻松文档处理，轻量级需求 | Apache License 2.0 |
| Freemarker + XML | 基于模板引擎，需将 docx 转为 XML 模板 | 复杂模板 + 大量文本替换 | Apache License 2.0 |
| docx4j | 专注于 OOXML 格式，支撑复杂文档操作 | 处理 Content Control 等高级标签 | Apache License 2.0 |
| Aspose.Words | 功能全面，API 简洁，支持所有 Word 特性 | 企业级复杂文档处理 | 商业许可（需付费） |
本文重点讲解Apache POI和docx4j两种开源方案，兼顾免费性和实用性。
三、Apache POI 实现标签替换
Apache POI 是 Apache 基金会的开源项目，支持读写 Microsoft Office 格式文件。对于.docx 文档，其核心是通过XWPFDocument类操作 XML 结构。
3.1 环境准备
添加 Maven 依赖：
org.apache.poi poi-ooxml 5.2.4
org.apache.poi<