不能。python-docx默认不加载页眉页脚，需显式访问section并初始化header/footer；须断开链接、处理多节及首页/奇偶页差异；页码需XML级插入域代码；批量处理应控制并发、避免覆盖、检查文档状态。
用 python-docx 能不能直接操作页眉页脚？
不能。python-docx Document 对象默认不加载页眉页脚结构，即使文档里已有页眉，section.header 也可能返回 None 或空对象。必须显式访问节（section）并确保其具备页眉/页脚容器。
- Word 文档可能含多个
Section（如分节符前后），每节独立控制页眉页脚 - 新建的
Header必须通过section.header.is_linked_to_previous = False断开与前一节的链接，否则修改会失效 - 页眉内容需插入到
header.paragraphs[0]或新建段落，不能直接赋值字符串
from docx import Document
doc = Document("sample.docx")
section = doc.sections[0]
# 确保页眉可写
if section.header is None:
section.header = section._sectPr.add_headerReference(0) # 触发初始化（内部技巧）
header = section.header
p = header.paragraphs[0] if header.paragraphs else header.add_paragraph()
p.text = "机密 · 仅限内部使用"
批量处理时为什么有些文档页眉没生效？
常见原因不是代码逻辑错，而是 Word 文档本身状态干扰：
- 文档启用了「首页不同」或「奇偶页不同」，但脚本只改了
section.header，没同步处理section.first_page_header或section.even_page_header - 模板文档中页眉被设为“链接到前一节”，导致后续节的页眉无法单独编辑
- 使用
Document()新建空白文档时，sections默认只有 1 个，但打开已存在的多节文档后，len(doc.sections)可能为 1～N，必须遍历
实操建议：
- 统一关闭“首页不同”：
section.different_first_page_header_footer = False - 强制断开所有节的链接：
section.header.is_linked_to_previous = False（同理处理footer、first_page_header） - 对每个
section都执行页眉写入，不要假设只有一个节
页脚加页码怎么避免手动输入“第 X 页”？
python-docx 不支持原生页码字段（如 PAGE 域），但可通过插入 Word 域代码实现自动编号：
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
立即学习“Python免费学习笔记（深入）”；
- 插入域需用
run._r.append(...)底层 XML 操作 - 更稳妥的做法是：在页脚中插入固定文本 + 页码占位符（如
"第 {page} 页"），再用 Word 打开后按Ctrl+A → F9更新域（适合后期人工补救） - 若坚持全自动，可用
docx2python+lxml直接改底层 XML，但兼容性风险高，容易破坏文档结构
推荐折中方案（稳定且够用）：
footer = section.footer
p = footer.paragraphs[0] if footer.paragraphs else footer.add_paragraph()
p.alignment = 1 # 居中
run = p.add_run()
run.text = "第 "
run = p.add_run()
# 插入 PAGE 域（Word 会识别为页码）
fldChar = OxmlElement('w:fldChar')
fldChar.set(qn('w:fldCharType'), 'begin')
run._r.append(fldChar)
<p>instrText = OxmlElement('w:instrText')
instrText.set(qn('xml:space'), 'preserve')
instrText.text = ' PAGE '
run._r.append(instrText)</p><p>fldChar = OxmlElement('w:fldChar')
fldChar.set(qn('w:fldCharType'), 'end')
run._r.append(fldChar)
run = p.add_run()
run.text = " 页"</p>处理上千个文件时性能和稳定性怎么兜底？
纯 python-docx 逐个打开→修改→保存，I/O 开销大，且 Word 文档含复杂格式时易触发内存异常。
- 避免用
Document("in.docx").save("out.docx")覆盖原文件，先保存到临时路径，成功后再os.replace() - 加异常捕获并记录失败文件路径，不要让一个损坏文档中断整个批次
- 不要并发打开太多
Document实例（python-docx 非线程安全），可用concurrent.futures.ThreadPoolExecutor(max_workers=4)控制并发数 - 对超大文档（>10MB），考虑先用
zipfile解包检查word/settings.xml是否含w:attachedTemplate（模板引用），有则可能影响页眉渲染
真正卡住的点往往不是代码，而是 Word 自身的隐藏节属性或损坏的 header.xml —— 处理前用 Word 手动打开几个样本确认页眉可编辑，比调参更省时间。
