使用python-docx-oss无法提取Heading3的ilvl值问题咨询

核心原因：XPath路径层级错误 #

你之前写的XPath .//w:pPr/w:pStyle/w:numPr/w:ilvl/@w:val 结构完全错误——在Word的OOXML格式中，w:numPr（编号属性）是w:pPr（段落属性）的直接子节点，和w:pStyle（段落样式）是同级关系，并非嵌套在w:pStyle内部。这就是你无法提取到ilvl值的根本原因。

正确的提取方式 #

1. 提取列表级别（ilvl） #

使用修正后的XPath路径，直接从w:pPr下定位w:numPr：

from docx import Document

doc = Document("你的文档路径.docx")
with open("输出文件.txt", "w", encoding="utf-8") as f:
    for para in doc.paragraphs:
        if para.style.name == "Heading 3":
            para_xml = para._element
            # 正确的XPath路径
            ilvl_values = para_xml.xpath('.//w:pPr/w:numPr/w:ilvl/@w:val')
            if ilvl_values:
                ilvl = ilvl_values[0]  # 对应你提到的2（OOXML中列表级别从0开始计数）
                f.write(f"{para.text} (ilvl: {ilvl})\n")
            else:
                f.write(f"{para.text}\n")

2. 关于outlineLvl的说明 #

如果你想提取的是大纲级别（对应Heading3的默认大纲层级，OOXML中从0开始计数为2），而非列表编号级别，需要注意：

• 若大纲级别是通过样式内置定义的（比如默认Heading3），需要去styles.xml中查找对应样式的w:outlineLvl属性；
• 若段落直接设置了大纲级别，可使用XPath：.//w:pPr/w:outlineLvl/@w:val

验证结构参考 #

你提供的document.xml片段中ilvl值为2，对应的OOXML结构应该类似这样：

<w:pPr>
<w:pStyle w:val="Heading3"/>
<w:numPr>
<w:ilvl w:val="2"/>

</w:numPr>
</w:pPr>
可以看到w:numPr和w:pStyle是平级的，所以之前的嵌套路径必然找不到节点。

内容的提问来源于stack exchange，提问作者Booger21