如何使用Python+docxtpl修改Word模板中已存在的字体颜色？

docxtpl本身是基于变量替换的模板引擎，原生不支持直接修改模板里的静态内容样式，但可以通过以下两种方案实现需求：

方案1：将静态内容改为模板变量（推荐） #

如果模板里的目标内容可以提前设置为变量，这是最简洁的方式——直接用RichText给变量赋值时指定颜色：

from docxtpl import DocxTemplate, RichText

# 加载模板
doc = DocxTemplate("your_template.docx")
# 创建带颜色的RichText对象
colored_text = RichText("模板中原有的内容", color='FF0000')  # FF0000是红色的十六进制值
# 渲染上下文
context = {'target_var': colored_text}
doc.render(context)
# 保存结果
doc.save("output.docx")

注：需要先把模板里要改颜色的静态内容替换成{{target_var}}变量

方案2：渲染后用python-docx直接修改文档对象 #

如果无法修改模板结构（必须保留原有静态内容），可以在模板渲染完成后，直接操作生成的docx文档对象，遍历文本块修改颜色：

from docxtpl import DocxTemplate
from docx.shared import RGBColor

# 加载并渲染模板
doc = DocxTemplate("your_template.docx")
doc.render(your_context)  # 先完成模板变量替换

# 1. 修改普通段落中的目标内容颜色
for para in doc.paragraphs:
    for run in para.runs:
        if "需要修改颜色的静态内容" in run.text:
            run.font.color.rgb = RGBColor(255, 0, 0)  # RGB(255,0,0)对应红色

# 2. 如果目标内容在表格中，额外遍历表格单元格
for table in doc.tables:
    for row in table.rows:
        for cell in row.cells:
            for para in cell.paragraphs:
                for run in para.runs:
                    if "需要修改颜色的静态内容" in run.text:
                        run.font.color.rgb = RGBColor(255, 0, 0)

# 3. 如需处理页眉/页脚、文本框等特殊区域，可参考python-docx的对应API扩展逻辑

# 保存修改后的文档
doc.save("output.docx")

注意事项 #

• 若目标内容被Word拆分成了多个run（比如中间有格式变化），需要逐个匹配或合并后处理
• 颜色值可以用十六进制字符串（如'FF0000'）或RGBColor对象传递
• 特殊区域（如页眉、文本框）的遍历逻辑需要单独实现，可参考python-docx官方文档的结构遍历方法

内容的提问来源于stack exchange，提问作者CYL