Document()创建的文档默认无页眉页脚，因基于minimal.docx且未初始化header/footer结构；需手动加载含页眉页脚的模板或显式启用section.header/footer。

用 python-docx 生成合同模板时，为什么 Document() 创建的文档没有页眉页脚？

因为 python-docx 默认创建的是空白文档（基于 minimal.docx），不带内置的页眉/页脚节结构。合同模板通常需要固定页眉（如“甲方：XXX”）、页脚（如“第 1 页 共 {total} 页”），但直接调用 document.sections[0].header 会报 AttributeError —— 节对象存在，但 header/footer 是 None，需手动初始化。

实操建议：

• 先用 Word 手动新建一个含页眉页脚的 .docx 文件（哪怕只打几个字），保存为 template_base.docx，后续用 Document('template_base.docx') 加载，再操作
• 若必须从零构建，得显式添加节并启用 header/footer：

  section = document.sections[0]
  section.different_first_page_header_footer = True
  header = section.header
  # 此时 header 才可写入段落
  header.paragraphs[0].text = "XX有限公司 合同专用章"

• 注意：页眉页脚中的动态内容（如页码、日期）无法用 python-docx 自动更新，只能插入固定文本或占位符（如 {{page_num}}），后续靠 Word 打开后按 Ctrl+A → F9 刷新域

如何安全替换合同里的变量占位符（如 {{party_a}}）而不误伤正文格式？

直接用 paragraph.text.replace() 会清空原有字体、加粗、超链接等格式，导致合同失去法律文书应有的排版严谨性。真正安全的方式是遍历所有 run 对象，在保持格式的前提下替换文本。

实操建议：

• 不要对整个段落做 .text 替换；改用函数逐 run 处理：

  def replace_in_paragraph(paragraph, old, new):
      for run in paragraph.runs:
          if old in run.text:
              run.text = run.text.replace(old, new)

• 对表格单元格同样适用：for cell in table.rows[0].cells: for paragraph in cell.paragraphs: replace_in_paragraph(paragraph, ...)
• 避免正则全局匹配：像 {{.*?}} 可能跨 run 匹配失败，优先用确定字符串（如 '{{client_name}}'），替换前确保模板中占位符唯一且无嵌套
• 敏感字段（如金额、身份证号）建议额外加粗或加下划线，可在替换后追加：run.bold = True

批量生成上百份合同时，python-docx 内存暴涨甚至崩溃怎么办？

每调用一次 Document() 就加载一份完整 OOXML 结构，生成 100 份意味着内存里驻留 100 个文档对象，尤其含图片或复杂表格时极易 OOM。这不是 bug，是设计使然 —— python-docx 不支持“复用文档骨架”。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

实操建议：

• 用模板文件 + zipfile 直接修改 XML（进阶）：把 template.docx 当 ZIP 解压，替换 word/document.xml 中的占位符，再打包回 .docx。速度快、内存恒定，但需熟悉 WordprocessingML 结构
• 更实用的折中法：生成完一份立即保存并 del document，强制触发 GC；配合 with open(...) 确保文件句柄释放
• 禁用图像嵌入：如果合同只需文字+表格，初始化时传参 Document('template.docx', image_path=None)（虽文档未公开，但源码中确有该参数逻辑）
• 别用 document.save() 循环内反复打开/关闭同一路径，易触发 Windows 文件锁；应为每份合同生成唯一文件名，如 f"contract_{client_id}.docx"

合同需要电子签章位置和防篡改水印，python-docx 能实现吗？

不能原生支持。签章本质是嵌入带数字证书的 OLE 对象或 Base64 图片+签名域，python-docx 无法写入签名流；水印是页眉中带旋转文字的形状（wps:wsp 命名空间），其 XML 结构复杂且依赖 Word 渲染引擎。

实操建议：

• 签章位置可用 add_picture() 插入透明 PNG 占位图，并标注“此处加盖电子签章”，实际签署交由专门 SDK（如 eSign、法大大 API）完成
• 水印退而求其次：在页眉插入浅灰色、大字号、旋转 -30° 的文字段落，用 run.font.color.rgb = RGBColor(200, 200, 200) 模拟，虽非真水印但视觉有效
• 防篡改靠外部机制：生成后用 hashlib.sha256() 计算文档二进制哈希值，存入数据库；交付时比对哈希，而非依赖 Word 内置功能

最常被忽略的一点：合同模板中所有日期、编号、金额字段，必须在替换后统一校验格式（如 datetime.now().strftime('%Y年%m月%d日')），而不是依赖用户输入 —— 人工填错一个“2023年02月30日”，整份合同就失去法律效力。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！