使用 Python 在 Excel 中添加页眉页脚（文本/图片/奇偶页差异设置）

在 Excel 表格处理中，页眉和页脚常用于展示文件名、公司标识、制作日期或页码等辅助信息。在打印或“页面布局”视图下，规范的页眉页脚能让文档显得更加专业严谨。本文将介绍如何使用 Spire.XLS for Python 库，通过 Python 代码为 Excel 工作表添加不同类型的页眉和页脚，主要涵盖以下场景：

1. 纯文本页眉页脚（含字体样式控制与动态页码/日期）
2. 图片页眉页脚（插入企业 Logo 或标志）
3. 奇偶页差异化页眉页脚（适用于双面打印装订）

环境准备

在进入代码介绍前，请先安装 Spire.XLS for Python，以免发生代码示例无法复用的情况。你可以通过 pip 命令一键安装：

pip install Spire.XLS

也可以导航到官网下载安装包进行自定义安装。此外，该组件还提供免费版，适用于测试和小型项目。

提示：Excel 中的页眉和页脚在“普通视图”下默认隐藏，需将视图切换至页面布局视图（Layout View）或在打印预览中才可以直观检查效果。

页眉页脚格式化代码速查表

在设置 Excel 页眉页脚时，可以通过特定的格式化脚本代码来实现动态信息填充（如页码、日期）或格式控制（如字体、颜色）。以下是常用的脚本代码汇总：

脚本代码	功能说明	示例 / 说明
&P	当前页码	自动填充当前页号
&N	总页数	自动填充总页数
&D	当前日期	动态获取系统当前日期
&T	当前时间	动态获取系统当前时间
&G	图像占位符	用于指定在何处显示设置的图片
&A	工作表名称	插入当前 Sheet 名称
&F	文件名称	插入当前工作簿文件名
&B	加粗	开关控制（再次使用取消加粗）
&I	倾斜	开关控制（再次使用取消倾斜）
&U	下划线	添加单下划线
&"字体名称"	设置字体	如 &"宋体" 或 &"Arial"
&+数字	设置字号	如 &14 表示 14 号字
&K+Hex颜色	设置字体颜色	如 &KFF0000 表示红色，&K191970 表示藏青色

在 Excel 中添加文本页眉与页脚

纯文本页眉页脚具有轻量、清晰、占用体积小的特点，是企业日常报表、财务明细和内部文件的首选方案。通过配合格式化脚本，不仅能灵活控制文字的字体、大小与颜色，还能动态追踪文档信，例如自动插入当前页码（&P）和系统日期（&D），无需手动维护，有效避免了因文件修改导致的页码错乱问题。

在 Spire.XLS 中，我们可以直接操作 PageSetup 对象的 LeftHeader、CenterFooter、RightFooter 等属性精准控制页眉页脚的位置。

示例代码：

下方代码展示了怎样同时添加 Excel 文件的页眉页脚：

from spire.xls import *
from spire.xls.common import *

inputFile = "示例文档.xlsx"
outputFile = "文本页眉页脚.xlsx"

# 创建 Workbook 实例并加载文档
workbook = Workbook()
workbook.LoadFromFile(inputFile)

# 获取第一个工作表
worksheet = workbook.Worksheets[0]

# 设置左侧页眉内容（字体: 宋体, 字号: 14）
worksheet.PageSetup.LeftHeader = '&"宋体"&14 文本页眉页脚'

# 设置中间页脚内容为动态“当前页码”
worksheet.PageSetup.CenterFooter = "&P"

# 设置右侧页脚内容为动态“当前日期”
worksheet.PageSetup.RightFooter = "&D"

# 设置视图模式为布局视图，方便直接查看效果
worksheet.ViewMode = ViewMode.Layout

# 保存文档并释放资源
workbook.SaveToFile(outputFile, ExcelVersion.Version2010)
workbook.Dispose()

在 Excel 文件中添加图片页眉与页脚

对于对外发布的正式报告、合同附件或商业提案，单靠文本往往不够直观。给页眉插入企业 Logo、部门徽标或水印，能极大提升文档的官方权威感与品牌辨识度。

在代码实现上，我们需要先通过 Image.FromFile() 加载本地图像资源，将图像绑定给对应的图片属性（如 LeftHeaderImage），然后再通过图像占位符 &G 告诉 Excel 在哪个位置将图片绘制出来。

示例代码：

下方代码展示了如何在页眉页脚添加品牌图片：

from spire.xls import *
from spire.xls.common import *

inputFile = "示例文档.xlsx"
outputFile = "/图片页眉页脚.xlsx"
inputImage = "/Logo1.png"

# 创建 Workbook 实例，加载 Excel 文件
workbook = Workbook()
workbook.LoadFromFile(inputFile)

# 获取第一个工作表
sheet = workbook.Worksheets[0]

# 使用 Stream 加载本地图片文件
image_stream = Stream(inputImage)

# 将图片流绑定至左侧页眉，并通过 "&G" 占位符指定显示
sheet.PageSetup.LeftHeaderImage = image_stream
sheet.PageSetup.LeftHeader = "&G"

# 如果页脚也需要显示，同理传入 stream
# sheet.PageSetup.CenterFooterImage = image_stream
# sheet.PageSetup.CenterFooter = "&G"

# 设置为页面布局视图
sheet.ViewMode = ViewMode.Layout

# 保存文档并释放资源
workbook.SaveToFile(outputFile, ExcelVersion.Version2010)
workbook.Dispose()

为 Excel 文件的奇偶页设置不同的页眉与页脚

在需要进行双面打印或装订成册，如制作年度审计报告、产品手册、技术文档时，单侧对齐的页眉页脚可能会导致装订后内侧文字被遮挡。通过开启“奇偶页不同”功能，我们可以让奇数页靠右显示、偶数页靠左显示，或者在左右两侧呈现不同的辅助标识，实现正式专业的排版效果。

在 Python 中，仅需要将 PageSetup.DifferentOddEven 属性设置为 1（开启），即可分别对 OddHeaderString、EvenHeaderString 等属性进行差异化设置。

示例代码：

下方为完整的示例代码：

from spire.xls import *
from spire.xls.common import *

inputFile = "示例文档.xlsx"
outputFile = "奇偶页页眉页脚.xlsx"

# 创建 Workbook 对象并加载 Excel 文件
workbook = Workbook()
workbook.LoadFromFile(inputFile)

# 获取第一个工作表
sheet = workbook.Worksheets[0]

# 开启奇偶页不同页眉页脚设置 (设为 1 表示开启)
sheet.PageSetup.DifferentOddEven = 1

# 设置奇数页的页眉与页脚（以深蓝色表示，靠右/居中）
sheet.PageSetup.OddHeaderString = '&"仿宋"&12&B&K191970 奇数页页眉'
sheet.PageSetup.OddFooterString = '&"宋体"&10&K191970 第 &P 页'

# 设置偶数页的页眉与页脚（以红色表示，靠左/居中）
sheet.PageSetup.EvenHeaderString = '&"宋体"&12&B&KFF0000 偶数页页眉'
sheet.PageSetup.EvenFooterString = '&"宋体"&10&KFF0000 第 &P 页'

# 设置显示模式为页面布局视图
sheet.ViewMode = ViewMode.Layout

# 保存文档
workbook.SaveToFile(outputFile, ExcelVersion.Version2010)
workbook.Dispose()

总结

本文主要演示了如何通过 Python 与 Spire.XLS for Python 库灵活完成 Excel 页眉页脚的定制。无论是轻量的动态文本、企业 Logo 植入，还是面向双面印刷的奇偶页排版，都可以通过几行简洁的代码自动化完成，极大地提高你的表格处理与排版的效率。