求助：如何用Python-docx实现仅首页显示页眉图片

你当前的问题核心是混淆了普通页眉和首页专属页眉的对象。当开启different_first_page_header_footer=True后，Word会把首页页眉和其他页面的页眉分成两个独立对象：

• section.first_page_header：仅控制首页的页眉
• section.header：控制除首页外其他页面的页眉

你的代码把图片加到了普通页眉（section.header），同时错误的配置导致首页页眉被隐藏，这就出现了和需求相反的效果。

修正后的代码 #

from docx import Document
from docx.shared import Inches, Pt

doc = Document()
section = doc.sections[0]

# 开启首页与其他页面的页眉/页脚分离
section.different_first_page_header_footer = True

# 配置首页页眉：添加图片并调整格式
first_header = section.first_page_header
first_header.is_linked_to_previous = False  # 确保不继承前一节设置（显式设置更清晰）
first_header.paragraphs[0].paragraph_format.left_indent = -Inches(1.25)
first_header.add_paragraph().add_run().add_picture("./image/french_header.png")

# 配置普通页眉：清空内容，确保其他页面无页眉
normal_header = section.header
normal_header.is_linked_to_previous = False
# 清空普通页眉的所有段落
for para in normal_header.paragraphs:
    para.clear()

# 调整页眉距离（应用于整个节）
section.header_distance = Pt(0)

# 测试：添加多页内容验证效果
for _ in range(3):
    doc.add_paragraph("测试页面内容，用于验证页眉显示效果")
    doc.add_page_break()

doc.save("test_header.docx")

关键说明 #

• 必须明确区分first_page_header和header两个对象，图片要加到first_page_header里
• 普通页眉需要清空内容，避免其他页面显示多余元素
• is_linked_to_previous设为False是为了确保当前节的页眉不继承模板或前一节的设置，保证自定义配置生效

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