Python-docx 不应直接修改底层 XML，因其易破坏文档结构且缺乏验证；推荐通过 .element 属性获取 lxml 元素，配合 qn 和 OxmlElement 安全微调，如设置加粗属性。

Python-docx 并不直接暴露或鼓励用户修改底层 XML 结构。它是一个高层抽象库，设计目标是通过 Python 对象（如 Document、Paragraph、Run）操作文档语义内容，而非手动编辑 OpenXML 标签。

为什么不应直接改底层 XML

Word 文档（.docx）本质是 ZIP 压缩包，内部包含大量 XML 文件（如 document.xml、styles.xml），它们之间有严格引用关系和命名空间约束。直接修改：

• 极易破坏文档结构，导致 Word 打开时报错或自动修复（丢失格式/内容）
• python-docx 不会验证你改过的 XML，也不会同步更新相关部件（如 numbering.xml 或 settings.xml）
• 同一逻辑在不同 Word 版本或复杂样式下行为可能不一致

如果真需要控制 XML 级别，推荐方式

python-docx 提供了有限但安全的“透出”机制，让你在关键节点访问并微调底层 lxml.etree.Element 对象：

• 获取元素：用 .element 属性拿到对应 XML 元素，例如：paragraph.element 返回
  节点
• 添加/修改属性：用 .set() 设置命名空间属性，如 run.element.set(qn('w:val'), 'true')
• 插入子元素：用 lxml.etree.SubElement() 添加标准 OpenXML 子节点（需正确使用命名空间）
• 注意命名空间：必须用 from docx.oxml import qn 包装标签名，例如 qn('w:b') 而不是硬写 'w:b'

一个安全修改加粗状态的例子

想强制让某段文字的某个 Run 显示为加粗（绕过样式继承）：

from docx import Document
from docx.oxml import OxmlElement, qn
doc = Document('input.docx')
p = doc.paragraphs[0]
r = p.runs[0]
获取底层 w:r 元素
r_el = r.element
创建 w:rPr（运行属性）如果不存在
rPr = r_el.get_or_add_rPr()
创建并插入 w:b（加粗）元素
b = OxmlElement('w:b')
b.set(qn('w:val'), 'true')
rPr.append(b)
doc.save('output.docx')

更复杂需求的替代方案

若需深度定制 XML（如自定义 XML 部件、内容控件、数学公式、特殊标记）：

• 用 python-docx 生成基础结构，再用 zipfile 解压 docx，手动编辑 XML 文件，重新打包
• 改用 lxml + zipfile 全手动处理 OpenXML（适合熟悉 ECMA-376 规范的开发者）
• 考虑 docxtpl 库——基于 jinja2 模板，更适合带逻辑的批量 XML 定制

基本上就这些。直接改 XML 不是 python-docx 的设计路径，用好 .element + qn + OxmlElement 已能满足绝大多数“靠近底层”的需求，既可控又不易崩。