在处理大量定制化文档时，如合同、报告或个人信件，word 文档中的变量功能变得至关重要。变量允许你存储重用信息，如日期、名字或产品细节，使文档更具个性化和动态性。本文将详细介绍如何使用 spire.doc for python 插入、计数、检索和删除 word 文档变量，从而提升文档管理的效率和灵活性。
安装 spire.doc for python
本教程需要 spire.doc for python 和 plum-dispatch v1.7.4。您可以通过以下 pip 命令将它们轻松安装到 windows 中。
pip install spire.doc如果您不确定如何安装，请参考此教程： 如何在 windows 中安装 spire.doc for python
python 插入变量到 word 文档
word 变量的工作原理是基于“域”的概念，在word文档中插入一个变量时，实际上是在插入一个域，这个域指向了存储在文档属性或外部数据源中的某个值。更新域时，word 会重新计算这些域，显示最新的信息。
spire.doc for python 提供 variablecollection.add(name, value) 方法插入变量到 word，以下是详细步骤：
- 创建 document 类的对象。
- 调用 document.addsection() 方法创建一个新的章节。
- 调用 section.addparagraph() 方法在章节中创建一个新的段落。
- 调用 paragraph.appendfield(fieldname, fieldtype) 方法在段落中添加一个变量域（fielddocvariable），
- 调用 document.variablecollection.add(name, value) 方法在文档的变量集合中添加一个名为“公司名称”的变量，并为其赋值“冰蓝科技”。
- 设置 document.isupdatefields 为 true 更新域。
- 调用 document.savetofile() 方法保存结果文档。
- python
from spire.doc import *
# 创建一个document对象
document = document()
# 添加一个新的章节
section = document.addsection()
# 在章节中添加一个新的段落
paragraph = section.addparagraph()
# 向段落中添加一个域，类型为fielddocvariable
paragraph.appendfield("公司名称", fieldtype.fielddocvariable)
# 向文档变量集合中添加一个变量，键为"公司名称"，值为"冰蓝科技"
document.variables.add("公司名称", "冰蓝科技")
# 更新域
document.isupdatefields = true
# 将文档保存到指定路径
document.savetofile("添加变量.docx", fileformat.docx2016)
# 释放资源
document.dispose()
python 计算 word 文档的变量个数
使用 document.variables.count 属性获取变量个数，下面是详细步骤：
- 创建 document 类的对象。
- 调用 document.loadfromfile() 加载 word 文档。
- 调用 document.variables.count 属性获取变量个数。
- 输出到控制台。
- python
from spire.doc import *
# 创建一个document对象
document = document()
# 加载word文档
document.loadfromfile("添加变量.docx")
# 获取变量个数
count=document.variables.count
print(f"变量个数：{count}")
python 检索 word 文档的变量
spire.doc for python 提供 getnamebyindex(int index) 和 getvaluebyindex(int index) 根据索引获取变量名和变量值。下面是详细步骤：
- 创建 document 类的对象。
- 调用 document.loadfromfile() 加载 word 文档。
- 调用 document.variables.getnamebyindex(index) 方法获取变量名。
- 调用 document.variables.getvaluebyindex(index) 方法获取变量值。
- 也可以使用 document.variables.get_item(name) 根据变量名获取其值。
- 输出到控制台。
- python
from spire.doc import *
# 创建一个document对象
document = document()
# 加载word文档
document.loadfromfile("添加变量.docx")
# 根据索引0获取变量名
name=document.variables.getnamebyindex(0)
# 根据索引0获取变量值
value=document.variables.getvaluebyindex(0)
# 也可以直接通过变量名获取其值，这里获取"公司名称"对应的值
value1=document.variables.get_item("公司名称")
# 输出到控制台
print("变量名:", name)
print("变量值:", value)
python 删除 word 文档的变量
variablecollection.remove(name) 方法可以删除文档中的指定变量，参数为该变量的名称。
- 创建 document 类的对象。
- 调用 document.loadfromfile() 加载 word 文档。
- 调用 document.variables.remove(name) 方法移除变量。
- 设置 document.isupdatefields 为 true 更新域。
- 调用 document.savetofile() 方法保存结果文档。
- python
from spire.doc import *
# 创建一个document对象
document = document()
# 加载word文档
document.loadfromfile("添加变量.docx")
# 移除名称为“公司名称”的变量
document.variables.remove("公司名称")
# 更新域
document.isupdatefields = true
# 保存文档
document.savetofile("移除变量.docx",fileformat.docx2016)申请临时 license
如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用javascript。获取有效期 30 天的临时许可证。
