Python操作Word页眉页脚的完整指南

加班到晚上十点，终于改完了那份50页的季度报告。按下保存，关掉电脑，心里想着明天总算能交差了。

结果第二天一早，领导说：“小张，报告做得不错，但每页顶部加上公司Logo和保密级别，底部加上页码和日期。”

打开那50页的文档，瞬间愣住了。难不成要一页一页手动加？正当准备认命时，旁边同事瞥了一眼：“你不会用Python吗？几行代码的事。”

就这样，踏上了折腾Word页眉页脚的路。

选哪个库？这事儿得说清楚

Python操作Word文档，主流选择有两个：python-docx和Aspose.Words。前者是免费开源的轻量级选手，后者则是功能强大的商业产品。

对于日常办公自动化来说，python-docx的免费特性确实“真香”。虽然它在处理某些复杂格式时需要绕点弯路，但应对常规的页眉页脚设置绰绰有余。至于商业版，功能虽强，但需要付费。除非日常工作就是高强度、批量化地生成复杂格式文档，否则，先从免费工具入手是个更务实的选择。

安装过程非常简单：

pip install python-docx 

命令执行完毕，环境就准备好了。接下来，我们从零开始。

页眉页脚在哪里？先找到“节”

在Word的逻辑里，有一个核心概念叫“节”。每个文档至少包含一个节，而页眉和页脚正是隶属于“节”之下的对象。理解这一点，就好比找文件得先找到正确的文件夹。

from docx import Document

doc = Document()
section = doc.sections[0]  # 获取第一个节

一旦拿到了“节”这个对象，页眉和页脚就触手可及了：

header = section.header
footer = section.footer

看，就是这么直接。

往页眉里写点东西

页眉本质上就是一个可以放置文本和图片的特定区域。向其中添加内容的方法，和操作文档正文非常相似：

from docx import Document

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

# 获取页眉对象，并添加段落
header = section.header
header_para = header.paragraphs[0]  # 页眉默认就有一个空段落
header_para.text = "公司机密文件 - 严禁外传"

doc.sa ve("report.docx")

运行这段代码后，生成的文档每一页顶部都会显示这行警示文字。

如果想做得更专业一点，调整字体大小和对齐方式也很简单：

from docx.shared import Pt
from docx.enum.text import WD_PARAGRAPH_ALIGNMENT

header_para.text = "公司机密文件"
header_para.style.font.size = Pt(12)
header_para.alignment = WD_PARAGRAPH_ALIGNMENT.CENTER

页脚里加个页码

添加页码比插入普通文本稍微复杂一些，因为python-docx库没有提供直接的“页码”属性。不过，可以通过插入Word的域代码来实现自动页码功能。

from docx.oxml import OxmlElement
from docx.oxml.ns import qn

def add_page_number(paragraph):
    """在指定的段落中插入自动页码域代码"""
    run = paragraph.add_run()
    
    # 开始域代码
    fldChar = OxmlElement('w:fldChar')
    fldChar.set(qn('w:fldCharType'), 'begin')
    run._r.append(fldChar)
    
    # 页码指令
    instrText = OxmlElement('w:instrText')
    instrText.text = "PAGE"
    run._r.append(instrText)
    
    # 结束域代码
    fldChar = OxmlElement('w:fldChar')
    fldChar.set(qn('w:fldCharType'), 'end')
    run._r.append(fldChar)

# 使用方法
footer = section.footer
footer_para = footer.paragraphs[0]
add_page_number(footer_para)

保存文档并用Word打开，页脚处就会显示当前页码，并且这个页码会随着文档页数自动更新。

封面不要页眉？没问题

很多正式文档要求封面不显示页眉或页码，从第二页（即正文开始）才显示。这就需要用到“首页不同”的设置。

section = doc.sections[0]
section.different_first_page_header_footer = True

# 设置首页页眉（通常留空或放置特定内容）
first_header = section.first_page_header
first_header.paragraphs[0].text = ""  # 封面页眉留空

# 设置后续页面的正常页眉
normal_header = section.header
normal_header.paragraphs[0].text = "内部资料"

在书籍或长篇报告排版中，还有一个更细致的需求：奇数页和偶数页使用不同的页眉。例如，奇数页放章节名，偶数页放书名，这样翻阅起来会显得非常专业。

# 开启奇偶页页眉页脚不同
section.odd_and_even_pages_header_footer = True

odd_header = section.odd_page_header
odd_header.paragraphs[0].text = "第一章 Python基础"

even_header = section.even_page_header
even_header.paragraphs[0].text = "Python编程指南"

页眉里放个Logo

在页眉中加入公司Logo，能立刻提升文档的正式感和品牌识别度。

from docx.shared import Inches

header = section.header
para = header.paragraphs[0]
run = para.add_run()
run.add_picture("logo.png", width=Inches(1.5))

# 可以在图片后面添加文字
run = para.add_run("  某某科技有限公司")

需要注意的是，Logo图片的宽度建议控制在1到1.5英寸之间，过大会影响版面美观。同时，务必确保代码中的图片文件路径是正确的，否则程序会报错。

文档分节：不同部分不同设置

对于长文档，比如包含封面、目录、正文、附录的报告，通常需要分节。每一节都可以拥有独立的页眉页脚设置。

这里的关键操作是打断节与节之间“链接到前一节”的默认关系：

# 获取文档的第二节（索引为1）
section2 = doc.sections[1]

# 断开页眉和页脚与前一节的链接，使其可独立设置
section2.header.is_linked_to_previous = False
section2.footer.is_linked_to_previous = False

# 现在可以自由设置第二节的页眉了
section2.header.paragraphs[0].text = "正文部分的页眉"

这可以说是Word文档自动化操作的一个核心技巧：节是独立的格式设置单元，但默认会继承前一节的格式。想要实现差异化，第一步就是“断开链接”。

批量处理：几十个文档一键搞定

实际工作场景中，更常见的需求是批量处理多个文档。这时，写一个简单的循环脚本就能极大提升效率。

import os
from docx import Document

def add_header_to_all(directory, header_text):
    """给指定目录下所有.docx文件添加相同的页眉"""
    for filename in os.listdir(directory):
        if filename.endswith('.docx'):
            filepath = os.path.join(directory, filename)
            doc = Document(filepath)
            
            section = doc.sections[0]
            header = section.header
            header.paragraphs[0].text = header_text
            
            doc.sa ve(filepath)  # 覆盖原文件保存
            print(f"处理完成: {filename}")

# 调用函数，为“reports”文件夹下所有报告添加统一页眉
add_header_to_all("./reports", "2024年度报告")

原本需要手动操作几十次的工作，现在几秒钟就能全部完成。

踩坑提醒

使用python-docx修改已存在文档的页眉时，有一个常见的“坑”。如果原文档的页眉设置了“链接到前一节”，直接修改可能不生效。可靠的解决方法是先明确断开链接：

section = doc.sections[0]
section.header.is_linked_to_previous = False
# 断开链接后再进行后续操作

遵循“先断开，再操作”的原则，可以确保修改行为万无一失。

另一个常见问题是：代码添加了页码，但用Word打开后却不显示？别急，这通常是因为域代码没有更新。只需在Word中按Ctrl+A全选文档，再按F9键刷新所有域，页码就会正确显示出来。

结语

回到开头那个故事，那50页的报告，最终用Python脚本不到一秒就处理完毕，统一加上了要求的页眉页脚。领导对效率表示满意，而自己也因此赢得了宝贵的休息时间。

总结起来，页眉页脚无非是Word为每一页预留的固定区域。用Python操作它，核心逻辑就三步：找到文档的“节”，获取对应的页眉或页脚对象，然后像操作普通段落一样向里面添加内容。至于分节、断开链接、首页不同、奇偶页不同这些高级功能，本质上都是对“节”这个基本单元属性的灵活运用。

对于绝大多数日常办公和轻度自动化需求，python-docx这个免费库已经完全够用。如果未来需要构建复杂的企业级文档自动化流水线，届时再评估商业解决方案也为时不晚。

代码写完，记得保存，然后安心关电脑下班。

以上便是关于使用Python自动化处理Word页眉页脚的完整指南，更多深入技巧和应用场景，可以进一步探索相关文档和社区资源。