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，需手动初始化。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 先用 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 对象，在保持格式的前提下替换文本。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 不要对整个段落做
.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 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用模板文件 +
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 渲染引擎。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 签章位置可用
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日”，整份合同就失去法律效力。
