如何使用Python更新docx中的Docproperty字段并保留原有字段格式

核心原理 #

DOCPROPERTY域本质是绑定Word文档的自定义属性值，不需要直接修改域代码，只要更新对应的自定义属性值，DOCPROPERTY字段结构会完整保留，刷新域后即可显示最新值。之前使用的DocxTemplate.render()方法是直接替换占位符为静态文本，自然无法保留域格式。

实现步骤 #

1. 安装依赖 #

仅需要使用python-docx库即可完成操作：

pip install python-docx

2. 代码实现 #

from docx import Document
from docx.opc.constants import CONTENT_TYPE as CT

def update_docproperty(doc_path, prop_name, new_value, save_path=None):
    doc = Document(doc_path)
    # 读取文档自定义属性部件
    custom_props_part = doc.part.package.part_related_by(CT.OFFICE_CUSTOM_PROPERTIES)
    custom_props = custom_props_part.properties

    # 更新指定属性，不存在则新增
    if prop_name in custom_props:
        custom_props[prop_name] = new_value
    else:
        custom_props.append(prop_name, new_value)
    
    # 保存文档
    final_save_path = save_path if save_path else doc_path
    doc.save(final_save_path)

# 调用示例
update_docproperty("示例文档.docx", "variable_name", "需要更新的新内容", "更新后文档.docx")

3. 刷新域显示新值 #

Word默认不会自动刷新域内容，更新属性后可通过两种方式显示最新值：

• 打开保存后的文档，按Ctrl+A全选内容后按F9，所有DOCPROPERTY字段会自动读取新属性值，域格式完全保留
• 可提前在Word设置中开启「打开文档时自动更新域」选项，无需用户手动操作

注意事项 #

• 传入的prop_name必须和文档中{ DOCPROPERTY variable_name * MERGEFORMAT }里的variable_name完全一致，大小写、空格都不能有偏差
• 批量更新多个DOCPROPERTY字段时，只需循环更新对应的自定义属性即可，不需要单独处理每一个域

内容的提问来源于stack exchange，提问作者Дмитрий Соло