首页 > 脚本专栏 > python > Python Word插入页眉页脚

使用Python实现在Word文档中插入页眉页脚

2026-05-07 09:30:00 作者：Metaphor692

页眉和页脚是 Word 文档中不可或缺的元素,它们位于页面的顶部和底部区域,本文将介绍如何使用 Python 和 Spire.Doc 库在 Word 文档中添加和自定义页眉页脚,感兴趣的小伙伴可以了解下

页眉和页脚是 Word 文档中不可或缺的元素，它们位于页面的顶部和底部区域，通常用于显示文档标题、公司名称、页码、日期或其他重要信息。合理设计的页眉页脚不仅能提升文档的专业性，还能帮助读者更好地导航和理解文档结构。

本文将介绍如何使用 Python 和 Spire.Doc 库在 Word 文档中添加和自定义页眉页脚，包括文本内容、图片元素、页码以及不同页面的差异化设置等实用功能。

为什么需要在 Word 中添加页眉页脚？

在 Word 文档中使用页眉页脚有着重要的实际价值：

品牌标识：在页眉中添加公司 Logo 和名称，强化品牌形象
文档导航：通过页码帮助读者快速定位和引用特定页面
信息补充：显示文档标题、章节名、作者、日期等元数据
专业外观：统一的页眉页脚设计使文档看起来更加正式和专业
版权保护：在页脚添加版权声明或保密标识
多节管理：在不同章节使用不同的页眉页脚，适应复杂文档结构

通过 Python 自动化添加页眉页脚，可以批量处理多个文档，确保格式的一致性和准确性。

环境准备

首先，需要安装 Spire.Doc for Python 库。可以通过 pip 命令轻松完成安装：

pip install Spire.Doc

安装完成后，即可在 Python 脚本中导入该库并使用其提供的页眉页脚功能。

基础操作：添加文本和图片页眉页脚

使用 HeadersFooters 属性添加内容

Spire.Doc 提供了 HeadersFooters 属性来访问和管理文档的页眉和页脚区域。通过在这个区域添加段落、文本和图片，可以创建丰富多样的页眉页脚设计。

以下代码展示了如何为 Word 文档添加包含图片和文本的页眉，以及包含页码的页脚：

from spire.doc import *
from spire.doc.common import *

def InsertHeaderAndFooter(section):
    """为指定节添加页眉和页脚"""
    header = section.HeadersFooters.Header
    footer = section.HeadersFooters.Footer

    # 在页眉中添加图片和文本
    headerParagraph = header.AddParagraph()
    
    # 添加页眉图片
    headerPicture = headerParagraph.AppendPicture("F:/备用图片/Logo1.png")
    
    # 添加页眉文本
    text = headerParagraph.AppendText("Spire.Doc 演示文档")
    text.CharacterFormat.FontName = "Arial"
    text.CharacterFormat.FontSize = 10
    text.CharacterFormat.Italic = True
    
    # 设置文本右对齐
    headerParagraph.Format.HorizontalAlignment = HorizontalAlignment.Right
    
    # 添加底边框
    headerParagraph.Format.Borders.Bottom.BorderType = BorderStyle.Single
    headerParagraph.Format.Borders.Bottom.Space = 0.05
    
    # 设置图片环绕方式为衬于文字下方
    headerPicture.TextWrappingStyle = TextWrappingStyle.Behind
    
    # 设置图片位置 - 左上角
    headerPicture.HorizontalOrigin = HorizontalOrigin.Page
    headerPicture.HorizontalAlignment = ShapeHorizontalAlignment.Left
    headerPicture.VerticalOrigin = VerticalOrigin.Page
    headerPicture.VerticalAlignment = ShapeVerticalAlignment.Top
    
    # 设置页脚
    footerParagraph = footer.AddParagraph()
   
    
    # 添加页码：当前页 / 总页数
    footerParagraph.AppendField("页数", FieldType.FieldPage)
    footerParagraph.AppendText(" / ")
    footerParagraph.AppendField("总页数", FieldType.FieldNumPages)
    footerParagraph.Format.HorizontalAlignment = HorizontalAlignment.Right
    
    # 添加顶边框
    footerParagraph.Format.Borders.Top.BorderType = BorderStyle.Single
    footerParagraph.Format.Borders.Top.Space = 0.05

# 定义输入和输出文件路径
inputFile = "/input/示例文档.docx"
outputFile = "/output/HeaderAndFooter.docx"

# 创建 Word 文档对象
document = Document()

# 从磁盘加载文档
document.LoadFromFile(inputFile)

# 获取第一个节
section = document.Sections[0]

# 插入页眉和页脚
InsertHeaderAndFooter(section)

# 保存为 docx 文件
document.SaveToFile(outputFile, FileFormat.Docx)
document.Close()

这个示例展示了创建完整页眉页脚的关键步骤：

访问页眉页脚区域：通过 section.HeadersFooters.Header 和 Footer 获取页眉和页脚对象
添加段落：使用 AddParagraph() 方法在页眉页脚中创建段落容器
插入图片：使用 AppendPicture() 方法添加图片，并设置其位置和环绕方式
添加文本：使用 AppendText() 方法添加文本，并设置字体格式
插入页码字段：使用 AppendField() 方法添加动态页码字段（FieldPage 表示当前页，FieldNumPages 表示总页数）
设置对齐和边框：通过段落格式设置水平对齐方式和边框样式

这种组合使用图片和文本的方式可以创建出视觉效果丰富的页眉页脚，适合企业报告、正式文档等场景。

高级页眉页脚设置

首面不同的页眉页脚

在许多正式文档中，封面页通常需要特殊的页眉页脚设计，或者完全不需要页眉页脚。Spire.Doc 支持通过 DifferentFirstPageHeaderFooter 属性来实现首面与其他页面不同的页眉页脚设置。

以下示例演示了如何为文档设置首面不同的页眉页脚：

from spire.doc import *
from spire.doc.common import *

# 定义输入和输出文件路径
inputFile = "./Data/MultiplePages.docx"
outputFile = "DifferentFirstPage.docx"

# 加载文档
doc = Document()
doc.LoadFromFile(inputFile)

# 获取第一节并启用首面不同设置
section = doc.Sections[0]
section.PageSetup.DifferentFirstPageHeaderFooter = True

# 设置首页页眉 - 添加图片
paragraph1 = section.HeadersFooters.FirstPageHeader.AddParagraph()
paragraph1.Format.HorizontalAlignment = HorizontalAlignment.Right
headerimage = paragraph1.AppendPicture("./Data/E-iceblue.png")

# 设置首页页脚
paragraph2 = section.HeadersFooters.FirstPageFooter.AddParagraph()
paragraph2.Format.HorizontalAlignment = HorizontalAlignment.Center
FF = paragraph2.AppendText("首页页脚")
FF.CharacterFormat.FontSize = 10

# 设置其他页面的页眉页脚
paragraph3 = section.HeadersFooters.Header.AddParagraph()
paragraph3.Format.HorizontalAlignment = HorizontalAlignment.Center
NH = paragraph3.AppendText("Spire.Doc for Python")
NH.CharacterFormat.FontSize = 10

paragraph4 = section.HeadersFooters.Footer.AddParagraph()
paragraph4.Format.HorizontalAlignment = HorizontalAlignment.Center
NF = paragraph4.AppendText("E-iceblue")
NF.CharacterFormat.FontSize = 10

# 保存文档
doc.SaveToFile(outputFile, FileFormat.Docx)
doc.Close()

这段代码的关键在于区分两种不同的页眉页脚对象：

FirstPageHeader 和 FirstPageFooter：仅应用于文档的第一页
Header 和 Footer：应用于除第一页外的所有页面

通过启用 DifferentFirstPageHeaderFooter = True，Word 会自动识别并应用不同的页眉页脚设计。这种设置非常适合以下场景：

封面页不需要页码
首页显示文档标题，其他页显示章节名称
首页使用特殊的设计元素

在分节文档中添加页码

对于包含多个节的长文档（如书籍、论文或大型报告），每个节可能需要独立编排页码。Spire.Doc 允许在每个节的页脚中添加页码，并控制页码的起始值和是否重新编号。

以下代码展示了如何在多节文档中为每个节添加页码：

from spire.doc import *
from spire.doc.common import *

# 定义输入和输出文件路径
inputFile = "./Data/Template_Docx_4.docx"
outputFile = "AddPageNumbersInSections.docx"

# 创建 Word 文档对象
document = Document()

# 从磁盘加载文件
document.LoadFromFile(inputFile)

# 遍历所有节，为每个节添加页码
for i in range(0, 3):
    # 获取当前节的页脚
    footer = document.Sections[i].HeadersFooters.Footer
    footerParagraph = footer.AddParagraph()
    
    # 添加页码字段：当前页 / 本节总页数
    footerParagraph.AppendField("page number", FieldType.FieldPage)
    footerParagraph.AppendText(" / ")
    footerParagraph.AppendField("number of pages", FieldType.FieldSectionPages)
    footerParagraph.Format.HorizontalAlignment = HorizontalAlignment.Right
    
    # 如果不是最后一节，设置下一节重新编号
    if i == 2:
        break
    else:
        document.Sections[i + 1].PageSetup.RestartPageNumbering = True
        document.Sections[i + 1].PageSetup.PageStartingNumber = 1

# 保存文件
document.SaveToFile(outputFile, FileFormat.Docx2013)
document.Close()

这个示例展示了分节页码管理的几个重要概念：

FieldSectionPages：显示当前节的总页数，而非整个文档的总页数
RestartPageNumbering：设置为 True 时，新节从起始页码重新开始编号
PageStartingNumber：设置节的起始页码值

这种设置非常适合以下场景：

前言部分使用罗马数字，正文部分使用阿拉伯数字
每个章节独立编页码
附录部分单独编号

实际应用

页眉页脚功能在实际工作中有广泛的应用场景：

批量添加公司品牌标识

企业可以为所有对外文档批量添加统一的页眉页脚，包含公司 Logo、名称和联系方式，确保品牌形象的一致性：

from spire.doc import *
from spire.doc.common import *
import os

def AddCompanyBranding(input_folder: str, output_folder: str, logo_path: str):
    """为文件夹中的所有 Word 文档添加公司品牌页眉页脚"""
    
    # 如果输出文件夹不存在则创建
    if not os.path.exists(output_folder):
        os.makedirs(output_folder)
    
    # 遍历输入文件夹中的所有文件
    for filename in os.listdir(input_folder):
        if filename.endswith(".docx"):
            input_path = os.path.join(input_folder, filename)
            output_path = os.path.join(output_folder, filename)
            
            # 加载文档
            doc = Document()
            doc.LoadFromFile(input_path)
            
            # 为每个节添加页眉页脚
            for section in doc.Sections:
                header = section.HeadersFooters.Header
                headerParagraph = header.AddParagraph()
                
                # 添加公司 Logo
                logo = headerParagraph.AppendPicture(logo_path)
                logo.Width = 50
                logo.Height = 50
                
                # 添加公司名称
                text = headerParagraph.AppendText("某某科技有限公司")
                text.CharacterFormat.FontName = "微软雅黑"
                text.CharacterFormat.FontSize = 12
                text.CharacterFormat.Bold = True
                
                headerParagraph.Format.HorizontalAlignment = HorizontalAlignment.Center
                
                # 添加页脚页码
                footer = section.HeadersFooters.Footer
                footerParagraph = footer.AddParagraph()
                footerParagraph.AppendField("page", FieldType.FieldPage)
                footerParagraph.Format.HorizontalAlignment = HorizontalAlignment.Center
            
            doc.SaveToFile(output_path, FileFormat.Docx2013)
            doc.Close()
            print(f"已处理: {filename}")

# 使用示例
input_folder = "./待处理文档"
output_folder = "./已处理文档"
logo_path = "./Data/CompanyLogo.png"
AddCompanyBranding(input_folder, output_folder, logo_path)

学术论文格式化

学生和研究人员可以自动为论文添加符合学术规范的页眉页脚，包括论文标题、作者姓名、页码等信息。

合同文档管理

法务部门可以为合同文档添加保密标识、合同编号和版本号等信息到页眉页脚中，便于文档管理和追踪。

培训材料制作

教育机构可以为培训手册添加课程名称、章节标题和页码，方便学员快速定位学习内容。

实用技巧

在 Word 文档中添加页眉页脚时，以下技巧可以帮助获得更好的结果：

图片尺寸控制：插入页眉页脚的圖片应适当调整大小，避免占用过多空间影响正文阅读
边距设置：确保页眉页脚内容与页面边缘保持适当距离，可通过 PageSetup 调整边距
字体一致性：页眉页脚使用的字体应与文档整体风格协调，通常选择简洁易读的字体
页码格式：根据文档类型选择合适的页码格式，如简单数字、"第 X 页"或"X / Y"形式
奇偶页不同：对于双面打印的文档，可以考虑设置奇偶页不同的页眉页脚
预览检查：添加完成后务必在多页视图中检查页眉页脚的显示效果

总结

通过本文的介绍，我们学习了使用 Python 和 Spire.Doc 库在 Word 文档中添加页眉页脚的多种方法：

使用 HeadersFooters 属性访问页眉页脚区域并添加文本和图片
设置首面不同的页眉页脚，适应封面特殊需求
在分节文档中添加独立编排的页码
实现批量处理功能为多个文档添加统一的品牌标识

这些技术为 Word 文档的专业化排版提供了强大的工具。掌握这些技能后，您将能够高效地创建格式规范、外观专业的文档，显著提升文档的质量和可读性。

到此这篇关于使用Python实现在Word文档中插入页眉页脚的文章就介绍到这了,更多相关Python Word插入页眉页脚内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！