word通过「自定义xml部件+内容控件绑定」识别xml字段，需手动绑定路径（如/root/user/name），且必须显式刷新控件；python-docx无法操作xml部件，推荐win32com（windows）或docxtpl（跨平台）。
Word模板怎么识别XML里的字段
Word本身不直接“解析”XML，它靠的是「自定义XML部件」+「内容控件绑定」这套机制。你得先在Word里手动把Plain Text Content Control或Rich Text Content Control绑定到XML Part里的某个节点路径，比如/root/user/name——不是靠文件名匹配，也不是靠标签名自动对齐。
常见错误现象：XML数据导入后内容控件全空，大概率是绑定路径写错了，或者XML Part没插入成功；也可能是Word默认禁用了XML功能（尤其新版Office默认关闭）。
- 务必用
Developer选项卡 →XML Mapping Pane确认XML Part已加载且路径可展开 - 绑定时右键内容控件 →
Properties→ 在Content Control Properties里点Map to XML part，选中对应节点 - XML根节点名必须和模板里绑定的路径前缀一致，比如绑定路径是
/data/person/id，那XML第一行就得是<data><person><id></id></person></data> - Word不支持XPath 2.0以上语法，不能用
concat()或for表达式，只认基本路径和简单谓语（如/list/item[1]/name）
Python用python-docx能直接填XML模板吗
不能。python-docx读不到Word里绑定的XML部件，也改不了内容控件背后的XML Part。它只能操作普通段落、表格这些可见结构，对「XML映射」完全无感——相当于你拿它去编辑一个带数据库连接的Excel，它只看得见单元格文字，看不见ODBC配置。
真正可行的路只有两条：用win32com调Word COM接口（Windows专属），或用docxtpl这种基于OpenXML的模板引擎（跨平台，但要求你放弃“Word原生XML绑定”，改用Jinja2语法）。
-
win32com方案能完整走通原生流程：打开文档 → 加载XML Part → 调用Document.XMLNodes更新节点值 → 刷新内容控件 -
docxtpl不依赖Word安装，但XML要转成Python字典，模板里写{{ user.name }}而不是绑定路径，本质是渲染式生成，不是“填充已有XML部件” - 别试
lxml直接改document.xml：内容控件的值存在settings.xml和websettings.xml里，路径分散，极易破坏包结构
导出时XML数据没刷新进内容控件
这是最常被忽略的一步：Word不会自动把XML Part变更同步到已绑定的内容控件里，必须显式触发刷新。即使你用COM改了XMLNode.Text，控件还是旧值，除非调ContentControl.XMLMapping.Update或全文档UpdateXML。
典型错误场景：代码执行完没报错，打开Word一看字段全空，其实XML Part已经更新，只是没“推”给界面。
- 用
win32com时，每改完一个节点，立刻对对应内容控件调cc.XMLMapping.Update() - 如果批量更新，更稳妥的是最后执行
doc.UpdateXML()（注意不是Save()） - Mac版Word不支持COM，也没
UpdateXML等API，这条路在Mac上根本走不通 - Office 365网页版完全不支持XML部件操作，连开发人员工具都看不到XML Mapping Pane
为什么XML字段填进去后格式乱了
因为内容控件分Plain Text和Rich Text两种，绑定同一XML节点时行为完全不同：Plain Text会丢掉所有格式（包括换行、加粗），Rich Text保留但可能错位——尤其当XML里含HTML标签或特殊字符时，Word会当成纯文本渲染，而不是解析。
例如XML里传<p>第一行<br>第二行</p>，Rich Text控件只会显示<p>第一行<br>第二行</p>这串字符，不会换行。
- 想保留换行？XML里用
<br> - 想加粗/斜体？得在Word模板里预先设好样式，再用
Rich Text控件绑定，XML只传纯文本，样式由Word控制 - 中文XML里如果有
“这类HTML实体，Word不识别，会原样打出，需提前转成Unicode字符
XML和Word的映射不是管道直连，中间隔着两层抽象：XML Part存储、内容控件绑定逻辑。任何一环路径错、编码乱、刷新漏，都会导致字段“看不见”。最稳的做法是先手工在Word里走通一次全流程，再写代码复现——别跳过这步。
