做报表的人大概都经历过这种场景:一份销售表打印出来,右边两列被截断;另一份财务表每页都缺表头;还有的报表页边距忽大忽小,装订后文字被压住。逐份手动调页面设置既费时又容易漏。本文用 Python 把这些设置交给代码,一次性统一所有报表的打印格式。

Excel 的页面设置项很多:纸张、方向、边距、打印区域、重复标题、缩放、页眉页脚……手动调一份不难,难的是几十上百份报表都要调成一致。用代码做这件事的好处很直接:
本文使用 Free Spire.XLS for Python 来演示,覆盖从基础纸张设置到页眉页脚、高级打印选项的完整流程。
pip install spire.xls.free先看一个最小可运行例子,感受一下 API 的调用方式:
from spire.xls import *
wb = Workbook()
ws = wb.Worksheets[0]
ws.Name = "示例页"
ps = ws.PageSetup
ps.PaperSize = PaperSizeType.PaperA4 # A4 纸
ps.Orientation = PageOrientationType.Landscape # 横向
wb.SaveToFile("minimal.xlsx", ExcelVersion.Version2013)
wb.Dispose()这里的关键对象是 ws.PageSetup。后面所有打印相关的属性——纸张、方向、边距、区域、标题、缩放、页眉页脚——都挂在这个对象上。先把这一点记住,后面的代码就只是往它身上挂不同属性而已。
下面用一个"区域销售明细"的场景,把最常用的页面属性一次性配好。注意这版代码的变量命名、数据结构和原文不同,但覆盖的设置项是一致的。
from spire.xls import *
wb = Workbook()
ws = wb.Worksheets[0]
ws.Name = "区域销售明细"
# ---- 写入表头 ----
col_titles = ["区域", "品类", "金额(万)", "毛利率"]
for c, title in enumerate(col_titles, 1):
ws.Range[1, c].Text = title
# ---- 写入明细(用字典列表,和原文的二维列表区分开)----
rows = [
{"区域": "华东", "品类": "笔记本", "金额(万)": 120, "毛利率": "15%"},
{"区域": "华东", "品类": "平板", "金额(万)": 85, "毛利率": "12%"},
{"区域": "华北", "品类": "笔记本", "金额(万)": 95, "毛利率": "13%"},
{"区域": "华北", "品类": "平板", "金额(万)": 70, "毛利率": "10%"},
{"区域": "华南", "品类": "笔记本", "金额(万)": 110, "毛利率": "14%"},
{"区域": "华南", "品类": "平板", "金额(万)": 90, "毛利率": "11%"},
]
for r, item in enumerate(rows, start=2):
ws.Range[r, 1].Value = item["区域"]
ws.Range[r, 2].Value = item["品类"]
ws.Range[r, 3].Value = str(item["金额(万)"])
ws.Range[r, 4].Value = item["毛利率"]
ps = ws.PageSetup
# 纸张与方向
ps.PaperSize = PaperSizeType.PaperA4
ps.Orientation = PageOrientationType.Landscape
# 四周边距(英寸)
ps.TopMargin = 1.2
ps.BottomMargin = 1.2
ps.LeftMargin = 0.8
ps.RightMargin = 0.8
ps.HeaderMarginInch = 0.4
ps.FooterMarginInch = 0.4
# 只打印 A1:D5 这一块
ps.PrintArea = "A1:D5"
# 第 1 行作为重复标题行
ps.PrintTitleRows = "$1:$1"
# 内容在页面上居中
ps.CenterHorizontally = True
ps.CenterVertically = True
# 缩放到一页宽、一页高
ps.FitToPagesWide = 1
ps.FitToPagesTall = 1
# 页眉页脚
ps.LeftHeader = "&\"微软雅黑\"&12 区域销售明细"
ps.CenterFooter = "第 &P 页 / 共 &N 页"
ps.RightFooter = "生成日期:&D"
ws.Range.AutoFitColumns()
wb.SaveToFile("sales_pagesetup.xlsx", ExcelVersion.Version2013)
wb.Dispose()这段代码里值得单独说一下的几个点:
纸张与方向 :PaperSize 管纸张规格,Orientation 管横竖。列比较多的表用横向,能避免右边被裁掉。
边距 :四个边距属性单位是英寸;HeaderMarginInch / FooterMarginInch 控制的是页眉页脚和正文之间的距离,和四周边距是两回事,别混。
打印区域 :PrintArea 用标准 Excel 区域写法,比如 "A1:D5"。只想打印某一块时用它,比隐藏行列省事。
重复标题行 :PrintTitleRows 的格式是 "$起始行:$结束行","$1:$1" 就是每页都重复第 1 行。长表跨页时这个设置几乎是必加的。
缩放 :FitToPagesWide 和 FitToPagesTall 都设成 1,意思是"不管内容多少,压到一页宽一页高"。注意这会让内容整体缩小,字太小的话要权衡。
页眉页脚代码 :页眉页脚字符串里支持一批占位符,常用的有:
占位符 | 含义 |
|---|---|
&P | 当前页码 |
&N | 总页数 |
&D | 当前日期 |
&T | 当前时间 |
&"字体名"&字号 | 指定字体和字号 |
&B / &I | 加粗 / 斜体 |
除了上面这些"大项",还有一些开关在特定场景下很有用,比如内部核对用的表想打印网格线、打印批注、或者赶时间用草稿质量。
from spire.xls import *
wb = Workbook()
ws = wb.Worksheets[0]
ws.Name = "指标核对"
ws.Range[1, 1].Text = "指标"
ws.Range[1, 2].Text = "数值"
ws.Range[1, 3].Text = "单位"
metrics = [("总销售额", 150000, "元"),
("平均订单额", 2500, "元"),
("客户数", 1200, "人"),
("转化率", 0.15, "%")]
for r, (name, val, unit) in enumerate(metrics, start=2):
ws.Range[r, 1].Value = name
ws.Range[r, 2].NumberValue = val
ws.Range[r, 3].Value = unit
ps = ws.PageSetup
ps.IsPrintGridlines = True # 打印网格线
ps.IsPrintHeadings = True # 打印行号列标
ps.BlackAndWhite = True # 黑白输出
ps.Draft = True # 草稿质量,速度快
ps.PrintComments = PrintCommentType.InPlace # 批注打印在原位置
ps.PrintErrors = PrintErrorsType.NA # 错误值显示为 N/A
ws.Range.AutoFitColumns()
wb.SaveToFile("metrics_print.xlsx", ExcelVersion.Version2013)
wb.Dispose()这些开关的含义一目了然:IsPrintGridlines 控制网格线,IsPrintHeadings 控制行号列标,BlackAndWhite 走黑白,Draft 走草稿质量,PrintComments 决定批注怎么打,PrintErrors 决定错误值怎么显示。按需打开即可,默认一般都是关的。
把上面的内容串起来,用代码设置 Excel 页面属性的流程其实是固定的几步:
Workbook(),读现有文件用 LoadFromFile()。wb.Worksheets[索引]。ws.PageSetup,这是所有页面属性的入口。SaveToFile()。为方便查用,把常用属性整理成一张速查表:
属性 | 作用 |
|---|---|
PaperSize | 纸张规格(A3/A4/A5/Letter 等) |
Orientation | 打印方向(横向/纵向) |
TopMargin / BottomMargin / LeftMargin / RightMargin | 四周边距(英寸) |
HeaderMarginInch / FooterMarginInch | 页眉页脚边距(英寸) |
PrintArea | 打印区域,如 "A1:D5" |
PrintTitleRows / PrintTitleColumns | 重复标题行/列,如 "$1:$1"、"$A:$A" |
CenterHorizontally / CenterVertically | 页面水平/垂直居中 |
FitToPagesWide / FitToPagesTall | 缩放到的页宽/页高数 |
LeftHeader / CenterHeader / RightHeader | 页眉左/中/右 |
LeftFooter / CenterFooter / RightFooter | 页脚左/中/右 |
IsPrintGridlines / IsPrintHeadings | 打印网格线 / 行号列标 |
BlackAndWhite / Draft | 黑白打印 / 草稿质量 |
PrintComments / PrintErrors | 批注打印方式 / 错误值打印方式 |
页面设置本身不难,难的是批量、统一、可复用。用 Python 把纸张、方向、边距、打印区域、重复标题、缩放、页眉页脚这些属性写成代码,一次配置、到处复用,报表打印格式就能保持一致。
本文的示例覆盖了最常用的一批设置,实际使用时按业务需要挑着用即可。配合 Free Spire.XLS 本身的数据写入、格式设置、图表等功能,可以进一步把"生成报表 → 设置打印格式 → 输出文件"整条链路自动化。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。