本文介绍如何利用 python-docx 库精准地为 word 文档中特定单词设置字体颜色，避免误染整段文本，并提供简洁可靠的实现方案与实用注意事项。
本文介绍如何利用 python-docx 库精准地为 word 文档中特定单词设置字体颜色，避免误染整段文本，并提供简洁可靠的实现方案与实用注意事项。
在使用 python-docx 进行 Word 文档自动化处理时，一个常见但易出错的需求是：仅对文档中出现的某些关键词（如“and”“then”“said”等）单独变色，而不影响其所在 Run 的其他文字。许多开发者尝试直接操作 XML 元素（如 run._element 和
所幸，正确解法非常简洁：将目标词所在的原始 run 拆分为多个新 run，确保待高亮词独占一个 run，并为其单独设置颜色。以下是优化后的 highlight_words 函数：
from docx import Document
from docx.shared import RGBColor
def highlight_words(document, words):
# 确保 words 按长度降序排序，避免短词匹配长词子串（如 "go" 匹配 "going"）
words_sorted = sorted(words, key=len, reverse=True)
for paragraph in document.paragraphs:
# 逐个处理段落中的每个 run
for run in paragraph.runs[:]: # 使用切片创建副本，避免遍历时修改列表引发异常
original_text = run.text
if not original_text:
continue
# 对每个关键词进行替换并拆分
new_runs = []
remaining_text = original_text
for word in words_sorted:
if word.lower() in remaining_text.lower(): # 不区分大小写匹配
parts = remaining_text.split(word, 1) # 最多分割一次，保留后续内容
if parts[0]:
# 添加前缀文本（普通颜色）
new_runs.append((parts[0], None))
# 添加关键词（红色）
new_runs.append((word, RGBColor(255, 0, 0)))
remaining_text = parts[1] if len(parts) > 1 else ""
break # 每次只处理第一个匹配项，避免嵌套干扰；如需全量匹配，可改用循环+索引
else:
# 无匹配，保留原 run 内容
new_runs.append((remaining_text, None))
# 清空原 run 并插入新 runs
run.clear()
for text, color in new_runs:
new_run = run.add_run(text)
if color is not None:
new_run.font.color.rgb = color
⚠️ 关键注意事项：
Python 3.14.2
下载
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
- ✅ 不要直接修改 run._element 或 XML：python-docx 的底层 API 不保证稳定性，且无法精确控制字符级样式。
- ✅ 必须按词长倒序匹配（如先匹配 "There is" 再匹配 "and"），防止 "go" 错误匹配 "going" 中的子串。
- ✅ 区分大小写需谨慎：示例中使用 .lower() 实现模糊匹配，若需严格匹配，请移除 .lower() 并调整逻辑。
- ✅ 避免多次遍历同一 run：使用 paragraph.runs[:] 遍历副本，防止 run.clear() 导致迭代中断。
- ✅ 批量高亮建议预编译正则表达式：对超大文档或高频调用场景，可用 re.sub() + run.add_run() 组合提升性能。
最后，在你的 analyze() 函数中，只需调用该改进版即可：
# 替换原有 highlight_words 调用
highlight_words(doc, words_to_highlight)
doc.save(f"{filename[:-5]}_highlighted.docx")
此方案稳定、可读性强，兼容 python-docx>=0.8.11，适用于教学批注、写作辅助、合规审查等真实业务场景。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
