如何覆盖docxcompose模块的页眉页脚设置？取消合并文档主格式继承

方法一：用append参数保留子文档的节布局 #

docxcompose的append()方法默认会让子文档继承主文档的节配置（包括页眉页脚、页面尺寸等），你可以通过添加keep_section_layout=True参数，让子文档保留自身的原始布局和页眉页脚：

from docxcompose.composer import Composer
from docx import Document  # 注意补充导入Document类

if __name__ == "__main__":
    # 修正原代码中未定义的main()调用问题
    master = Document('template.docx')
    composer = Composer(master)
    doc2 = Document('test.docx')
    # 添加参数保留子文档的节设置
    composer.append(doc2, keep_section_layout=True)
    composer.save("final_output.docx")

方法二：手动替换页眉页脚（精细控制） #

如果需要更灵活地调整特定节的页眉页脚，可以手动遍历合并后的文档节，替换目标内容：

from docxcompose.composer import Composer
from docx import Document

if __name__ == "__main__":
    master = Document('template.docx')
    composer = Composer(master)
    doc2 = Document('test.docx')
    composer.append(doc2)
    
    # 获取合并后对应子文档的最后一个节
    target_section = composer.doc.sections[-1]
    # 获取子文档的页眉页脚模板
    source_header = doc2.sections[0].header
    source_footer = doc2.sections[0].footer
    
    # 清空目标节页眉并复制源页眉内容
    target_section.header._element.clear_content()
    for elem in source_header._element:
        target_section.header._element.append(elem)
    
    # 同理替换页脚
    target_section.footer._element.clear_content()
    for elem in source_footer._element:
        target_section.footer._element.append(elem)
    
    composer.save("final_output.docx")

注意事项 #

• 方法一适合需要完整保留子文档所有格式的场景，会保留子文档的所有节设置。
• 方法二更适合只修改特定节页眉页脚的场景，可按需调整目标节范围。

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