python-docx直接赋值paragraph.text会丢失格式，因该属性仅返回纯文本字符串、丢弃run的.bold/color/size等样式；真正保格式替换需按字符位置拆分并修改对应run.text，同时遍历表格、页眉页脚等区域。
python-docx 能批量替换并保留格式，但必须分层操作——段落级替换快但丢样式，run级替换保格式但需小心匹配逻辑。
为什么直接用 paragraph.text = paragraph.text.replace(...) 会破坏加粗/颜色？
因为 paragraph.text 是纯字符串拼接结果，它把同一段落里所有 run 的文本连成一串，但完全丢弃了每个 run 自身的 .bold、.font.color.rgb、.font.size 等属性。一旦你赋值新字符串，整个段落就退化为一个默认样式的 run，原来穿插的红色关键词、下划线术语全变回黑体常规字。
常见错误现象：合同中“违约金”原本是红色加粗，替换后变成普通黑色；页眉里的公司Logo文字被替换成新名称，但字号从10pt缩到9pt。
- 只适合替换整段无格式差异的内容，比如法律条款中的固定编号（
"第1条"→"第2条"） - 若原文档含表格、页眉页脚，这段代码完全不处理它们
- 大小写敏感，
"甲方"不会匹配"甲方："中的子串，除非你手动加空格或标点判断
如何真正保留原格式做精准替换？必须遍历 run
核心思路：不是改段落文本，而是定位到包含目标文字的 run，仅修改它的 .text，其他样式属性原封不动继承。
但要注意：run.text 很短（比如一个加粗词、一个带颜色数字），不能直接拿全文本去匹配——否则会漏掉跨 run 的词（如“违run1约run2金run3”）。所以实际要用“查找-拆分-重组”策略：
- 对每个
paragraph，先用paragraph.text做全局定位，拿到所有匹配起止位置 - 再按位置反向映射到具体哪些
run被覆盖，拆开这些run（用run._element.addnext()或新建run插入） - 只替换目标部分对应的
run.text，其余run不动
示例关键片段：
🎯 HR面试评价助手（Word版格式） 生成可直接复制到Word文档的标准格式HR面试评价 【使用方式】 1. 发送口令：HR面试评价 2. 粘贴JD文字 3. 上传简历文档 4. 上传面试记录（可选） 5. 复制生成的评价到Word 【输出特点】 - 纯文本格式，可直接粘贴到Word - 层次清晰，标题加粗...
for paragraph in doc.paragraphs:
full_text = paragraph.text
for old, new in replacements.items():
start = 0
while True:
pos = full_text.find(old, start)
if pos == -1:
break
# 此处需调用自定义函数 split_run_at_position(paragraph, pos, len(old), new)
start = pos + len(old)
这个逻辑比表面看起来重得多——python-docx 没有内置“按字符位置切 run”的方法，得手动操作底层 XML 元素（run._element），稍有不慎就让文档损坏打不开。
表格、页眉页脚里的内容怎么一起替换？
Document 对象不只管 paragraphs。遗漏这些区域是批量替换失败最常被忽略的原因。
- 表格：遍历
doc.tables→ 每个table.rows→ 每个cell.paragraphs→ 再进run替换 - 页眉：遍历
section.header.paragraphs（注意：每个Section可能有独立页眉） - 页脚：同理，用
section.footer.paragraphs - 文本框（
shape）：极少见但存在，需检查paragraph.part.partnames，通常跳过更安全
性能影响明显：处理一份含 5 个表格、3 个节的文档，耗时可能比纯正文高 3–4 倍。如果只是替换合同主体，建议先确认是否真需要动页眉——很多模板的页眉是域代码（Field），硬替换会失效。
统一字体/段落格式时，别碰 style 就直接设 run.font.name
直接设 run.font.name = "微软雅黑" 看似简单，但会导致样式体系混乱：后续人工修改时，Word 会显示“已应用直接格式”，无法用“清除格式”一键还原，且与标题样式冲突。
正确做法是优先修改段落所用的 style，再微调例外项：
- 先批量设置
paragraph.style = doc.styles['正文']（确保该样式本身已定义好字体/字号） - 对特殊段落（如表格内文字），单独设
cell.paragraphs[0].runs[0].font.size = Pt(10) - 避免对每个
run都设.font.name，尤其不要在循环里重复写run.font.name = "Times New Roman"—— 这会让文件体积暴增，且 Word 打开变慢
最容易被忽略的点：中文文档混用英文字体时，run.font.name 设的是西文字体名（如 "Times New Roman"），而 run.font.element.rPr.rFonts 才控制中文字体，漏掉后者会导致中文仍显示为宋体。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
