使用Python-docx将文档首页页眉复制到所有新增页面的实现问题

核心逻辑：python-docx中页眉绑定到文档的「节（Section）」对象，默认同一节下的所有页面共用页眉，前提是关闭「第一页使用独立页眉页脚」的设置。

你原有代码存在的问题：

• document.add_page_break 缺少括号，不会实际执行添加分页符的操作
• 调用的document.add_heading()是添加正文标题的方法，和页眉设置无关
• 不需要深度拷贝HeaderPart对象，直接复制页眉内的段落、表格等元素即可

完整可运行代码 #

from docx import Document
import copy

# 打开模板文档
document = Document("Template.docx")
# 获取第一节（默认所有内容都在第一节，除非主动新建节）
section = document.sections[0]

# 获取第一页页眉的内容
first_page_header = section.first_page_header
# 关闭「第一页使用独立页眉页脚」的设置，让整个节所有页面共用同一页眉
section.different_first_page_header_footer = False
# 获取节的默认页眉（所有非第一页共用的页眉）
default_header = section.header

# 清空默认页眉原有内容
for para in default_header.paragraphs:
    p = para._element
    p.getparent().remove(p)
# 复制第一页页眉的所有段落
for para in first_page_header.paragraphs:
    new_para = copy.deepcopy(para._element)
    default_header._element.append(new_para)
# 如果页眉里有表格，补充复制表格
for table in first_page_header.tables:
    new_table = copy.deepcopy(table._element)
    default_header._element.append(new_table)

# 现在添加任意数量的分页符/新内容，所有页面都会显示和第一页相同的页眉
# 示例：新增3页
for _ in range(3):
    document.add_page_break()
    # 可在此处添加新页面的正文内容

# 保存输出文档
document.save("Output.docx")

补充说明 #

如果你新增页面时主动调用了add_section()新建了节，需要给每个新节重复上述复制页眉的操作，也可以直接将新节的页眉关联到第一节的页眉：

new_section = document.add_section()
new_section.header._element = section.header._element

上述代码已经覆盖页眉包含段落、自定义格式、图片、表格的场景，无需额外调整。

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