使用python-docx为不同样式设置字体时遇到的问题

问题根源分析 #

你的代码出现标题样式被Normal覆盖的问题，核心原因有三点：

1. 内置Heading 1/2样式默认继承Normal的属性，未切断继承时自定义设置会被覆盖；
2. 错误设置了asciiTheme属性，导致Word调用主题字体而非指定的本地字体；
3. 段落样式分配时的clear()+add_run()操作可能残留原有格式，未让样式完全生效。

修复后的完整代码 #

from docx.oxml.ns import qn
from docx.shared import Pt, RGBColor
from docx.enum.text import WD_ALIGN_PARAGRAPH

def set_style(style, font_name, font_size, font_color, alignment):
    # 切断样式继承，避免被父样式覆盖
    if style.base_style is not None:
        style.base_style = None
    
    font = style.font
    font.name = font_name
    # 显式设置ascii和东亚字体属性，确保自定义字体生效
    font.element.rPr.rFonts.set(qn("w:ascii"), font_name)
    font.element.rPr.rFonts.set(qn("w:eastAsia"), font_name)
    
    font.size = Pt(font_size)
    font.color.rgb = RGBColor(*font_color)
    style.paragraph_format.alignment = alignment

# 应用所有样式设置
set_style(doc.styles['Normal'], 'Bell MT', 12, (0,0,0), WD_ALIGN_PARAGRAPH.JUSTIFY)
set_style(doc.styles['Heading 1'], 'Helvetica', 26, (255,0,0), WD_ALIGN_PARAGRAPH.LEFT)
set_style(doc.styles['Heading 2'], 'Bahnschrift', 20, (0,0,255), WD_ALIGN_PARAGRAPH.LEFT)

# 优化段落样式分配逻辑
for paragraph in doc.paragraphs:
    # 提取段落中所有run的字号，取平均值做匹配（容错浮点精度问题）
    run_sizes = [run.font.size.pt for run in paragraph.runs if run.font.size]
    if not run_sizes:
        continue
    
    avg_size = sum(run_sizes) / len(run_sizes)
    # 匹配24号字为Heading 1
    if abs(avg_size - 24) < 0.5:
        paragraph.style = doc.styles['Heading 1']
    # 匹配20号字为Heading 2
    elif abs(avg_size - 20) < 0.5:
        paragraph.style = doc.styles['Heading 2']

关键修复点说明 #

• 切断样式继承：通过style.base_style = None取消标题样式对Normal的继承，确保自定义的字体、对齐等属性完全生效；
• 字体属性修正：替换asciiTheme为w:ascii和w:eastAsia，强制Word使用指定的本地字体，而非主题默认字体；
• 简化样式分配：直接设置paragraph.style即可让样式覆盖整个段落，无需clear()和重新添加run，避免格式残留。

后续扩展需求参考 #

页眉页脚设置

# 获取文档第一个节的页眉和页脚
section = doc.sections[0]
# 设置页眉
header_paragraph = section.header.add_paragraph("文档页眉")
header_paragraph.style = doc.styles['Header']
header_paragraph.paragraph_format.alignment = WD_ALIGN_PARAGRAPH.CENTER
# 设置页脚
footer_paragraph = section.footer.add_paragraph("第 {PAGE} 页，共 {NUMPAGES} 页")
footer_paragraph.paragraph_format.alignment = WD_ALIGN_PARAGRAPH.CENTER

封面添加

# 在文档开头插入封面段落
cover_title = doc.add_paragraph("文档封面", style='Title')
cover_title.paragraph_format.alignment = WD_ALIGN_PARAGRAPH.CENTER
# 插入封面图片（需提前准备图片路径）
from docx.shared import Inches
doc.add_picture("cover_image.jpg", width=Inches(6))
# 将封面设置为单独一页
cover_title.paragraph_format.page_break_before = True

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