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

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

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

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

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

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

Python操作Word主要有两大家族：python-docx和Aspose.Words。前者免费开源，后者是商业产品但功能更强。

免费的真香。python-docx虽然有些地方需要绕弯路，但应付日常工作绰绰有余。商业版强大但收费，除非你的工作天天跟文档打交道，否则先别急着掏钱。

安装也很简单：

复制代码

pip install python-docx

搞定。我们从头开始。

页眉页脚在哪里？先找到"节"

Word文档里藏着一个概念叫"节"。每个文档至少有一个节，节下面才有页眉和页脚。这就像找文件得先进文件夹。

ini 复制代码

from docx import Document

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

拿到节之后，页眉和页脚就暴露了：

css 复制代码

header = section.header
footer = section.footer

就这么简单。

往页眉里写点东西

页眉其实就是一个可以放文字、图片的地方。往里面加内容的方式跟正文差不多：

ini 复制代码

from docx import Document

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

# 拿到页眉，加个段落
header = section.header
header_para = header.paragraphs[0]  # 默认就有一个段落
header_para.text = "公司机密文件 - 严禁外传"

doc.save("report.docx")

这段代码执行完，打开文档，每页顶部都会出现这行字。

想玩点花样？调整字体和对齐方式：

arduino 复制代码

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的域代码来实现。

python 复制代码

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)

保存文档后，页脚就会显示当前页码。

封面不要页眉？没问题

很多文档要求封面不显示页眉，从第二页开始才需要。这就需要用到"首页不同"的设置。

ini 复制代码

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 = "内部资料"

书籍排版还有个小讲究：奇数页和偶数页的页眉可以不一样。奇数页放章节名，偶数页放书名，打开书的时候左右两侧看起来特别协调。

ini 复制代码

# 开启奇偶页不同
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往页眉一放，文档档次立马不一样。

ini 复制代码

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英寸宽就够了。图片路径要写对，不然Word会报错。

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

长文档通常要分节。封面是一节，目录是一节，正文又是一节。每节的页眉页脚可以完全独立。

关键在于打断"链接到前一节"的关系：

ini 复制代码

# 获取第二节（索引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文档操作的核心秘密就在这里：节是独立单位，但默认会继承前一节，想独立就必须断开链接。

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

实际工作中经常要处理一堆文档。循环遍历就行了：

python 复制代码

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.save(filepath)  # 覆盖保存
            print(f"处理完成: {filename}")

# 使用
add_header_to_all("./reports", "2024年度报告")

几十个文件几秒钟就搞定了，不用一个个打开。

踩坑提醒

python-docx对已经存在的文档修改页眉时，有个坑要注意。如果文档的页眉以前被设置成"链接到前一节"，修改可能会不生效。解决办法很简单：

ini 复制代码

section = doc.sections[0]
section.header.is_linked_to_previous = False

先断开，再操作，保证没问题。

还有个常见问题：页码显示不出来怎么办？Word打开后按Ctrl+A全选，再按F9刷新所有域代码，页码就出来了。因为域代码需要手动触发更新。

结语

那50页的报告，我后来用Python跑了不到一秒就全部加好了页眉页脚。领导看了很满意，我也有时间提前下班。

页眉页脚这东西，说白了就是Word给每页加的一个固定区域。Python操作它，核心就是找到"节"，拿到页眉或页脚对象，然后往里面填内容。分节、断开链接、首页不同、奇偶不同，就这几个概念，弄懂了就能应对绝大多数场景。

如果你只是偶尔用，python-docx完全够用。如果要做很复杂的企业级文档自动化，再考虑商业方案也不迟。

代码写完了，记得关电脑下班。