Java 操作 Word 文档变量：添加与修改方法详解
作者：袖梨
2026-05-28
在办公自动化系统开发过程中，经常需要处理文档中重复出现的动态内容。本文将详细介绍如何通过Java代码高效管理Word文档变量，实现关键信息的全局同步更新。
一、环境配置
本方案采用专业的Java组件处理Word文档，支持主流文件格式。使用Maven项目时，请在配置文件中添加以下依赖：
com.e-iceblue
e-iceblue
e-iceblue
spire.doc
14.5.3
配置完成后，Maven会自动下载所需依赖包。
二、文档变量的工作机制
文档变量系统包含两个核心组件：
变量引用：通过特定类型字段插入文档正文作为占位符，支持同一变量名多次引用。
变量存储：以键值对形式保存在文档变量集合中。
其工作原理是：在文档中插入变量域并设置初始值后，触发字段更新即可实现全局显示。后续修改只需更新变量集合中的值，无需逐个修改引用位置。
三、在 Word 文档中添加变量
以下示例展示如何创建新文档并添加变量引用：
实现步骤：
初始化Document对象并添加文档节
创建段落内容
使用appendField方法插入变量域
通过变量集合为变量赋值
调用字段更新方法
保存最终文档
代码示例：
import com.spire.doc.Document;
import com.spire.doc.Section;
import com.spire.doc.documents.Paragraph;
import com.spire.doc.FieldType;
import com.spire.doc.VariableCollection;
import com.spire.doc.FileFormat;public class AddVariables {
public static void main(String[] args) {
Document document = new Document();
Section section = document.addSection();
section.getPageSetup().getMargins().setTop(80f);
Paragraph paragraph = section.addParagraph();
paragraph.appendField("SoftwareName", FieldType.Field_Doc_Variable);
paragraph.appendText(" 是一款面向企业的协作平台。rn");
paragraph.appendField("SoftwareName", FieldType.Field_Doc_Variable);
paragraph.appendText(" 支持多人实时编辑和版本管理。rn");
paragraph.appendField("SoftwareName", FieldType.Field_Doc_Variable);
paragraph.appendText(" 提供 7x24 小时技术支持服务。");
VariableCollection variables = document.getVariables();
variables.add("SoftwareName", "协作大师企业版");
document.isUpdateFields(true);
document.saveToFile("添加变量.docx", FileFormat.Auto);
document.close();
System.out.println("文档已生成，变量值为：协作大师企业版");
}
}
关键说明：必须执行字段更新操作，否则生成的文档可能显示原始域代码而非变量值。
四、修改已存在文档中的变量值
针对模板文档场景，可按照以下步骤修改变量值：
实现步骤：
加载现有文档
获取变量集合
更新指定变量值
执行字段更新
保存新文档
代码示例：
import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.VariableCollection;public class ChangeVariableValue {
public static void main(String
