Word CJK 排版修复器

解决 python-docx 的 CJK 排版缺陷

在使用 python-docx 处理包含中日韩（CJK）字符的文档时，常会遇到排版错乱的问题。底层库在写入样式时，run.font.name 仅设置了 w:ascii 和 w:hAnsi，遗漏了 w:eastAsia；同理，run.font.size 只写了 w:sz 而忽略了 w:szCs。这导致中文字符回退到系统默认字体和字号。此外，原文档中多个 run 混合格式在清理后容易残留旧样式，最终出现同一行文字大小不一、粗细不均的“斑马纹”现象。

核心机制与处理流程

本技能提供两种处理策略，遵循先合并 run 再设格式的原则，彻底杜绝样式残留：

• 完整格式化：适用于从零生成或需统一全局样式的文档。脚本会提取段落内所有 run 的文本并合并为单一节点，随后执行字体三写（ascii + hAnsi + eastAsia）与字号双写（sz + szCs），确保所有字符渲染一致。
• 轻量级修复：适用于已存在且仅追加了少量内容的文档。该方案不改变原有排版结构，仅针对新增或修改的部分补充 CJK 属性，实现平滑补救。

适用边界与注意事项

该技能专注于纯排版修复，严格遵循只做格式调整、不修改正文内容的原则，输出结果保持简洁，不添加多余装饰。需要注意的是，它主要依赖 python-docx 的标准 API，对于包含复杂 Word 原生特性（如文本框嵌套、艺术字或复杂宏）的文档，可能需要结合底层 XML 操作进行二次处理。