Python-docx库怎么修改Word文档的XML底层结构-XML/RSS教程-PHP中文网

Python-docx库怎么修改Word文档的XML底层结构

畫卷琴夢

发布： 2025-12-14 16:29:02

原创

899人浏览过

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

python-docx库怎么修改word文档的xml底层结构

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 返回 <p></p> 节点
添加/修改属性：用 .set() 设置命名空间属性，如 run.element.set(qn('w:val'), 'true')
插入子元素：用 lxml.etree.SubElement() 添加标准 OpenXML 子节点（需正确使用命名空间）
注意命名空间：必须用 from docx.oxml import qn 包装标签名，例如 qn('w:b') 而不是硬写 'w:b'

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

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

立即学习“Python免费学习笔记（深入）”；

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

185

查看详情

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

登录后复制