做报表的人大概都遇到过这类情况:销售表打印出来右边两列被截断,财务表每页都缺表头,页边距忽大忽小装订后文字被压住。逐份手动调页面设置既费时又容易漏项。本文用 Python 把这些设置写成代码,一次配置、批量复用,让所有报表的打印格式保持一致。
下面以 Free Spire.XLS for Python 为例,从纸张、方向、边距,到打印区域、重复标题行、缩放、页眉页脚,再到几个不常用的打印开关,完整梳理一遍 PageSetup 的用法。
一、为什么把页面设置交给代码
Excel 的页面设置项很多:纸张、方向、边距、打印区域、重复标题、缩放、页眉页脚等。手动调一份不难,难的是几十上百份报表都调成一致。改用代码处理的好处很直接:
1. 格式统一,不会出现这份 A4 横向、那份 Letter 纵向的混搭;
2. 批量处理时不会漏设某一项;
3. 设置逻辑可以复用,下次换数据源直接跑。
所有打印相关的属性都挂在 ws.PageSetup 这个对象上。先把这一点记住,后面的代码本质上就是往它身上挂不同的属性。
二、安装与最小示例
安装命令:
- pip install spire.xls.free
复制代码
先看一个最小可运行例子,感受 API 的调用方式:
- from spire.xls import Workbook, PaperSizeType, PageOrientationType
- from spire.xls.common import ExcelVersion
- 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()
复制代码
这段代码只做了两件事:把纸张设成 A4,把方向设成横向。其余属性保持默认,保存为 xlsx 即可。
三、一次性配置常用页面属性
下面用一个“区域销售明细”的场景,把最常用的页面属性一次性配好。示例用字典列表写数据,和直接写二维列表的做法区分开,但覆盖的设置项是一致的。
- from spire.xls import *
- from spire.xls.common import ExcelVersion
- 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()
复制代码
这段代码里有几处值得单独说明:
1. 纸张与方向
PaperSize 管纸张规格,Orientation 管横竖。列比较多的表用横向,能避免右侧列被裁掉。
2. 边距
TopMargin / BottomMargin / LeftMargin / RightMargin 四个属性单位是英寸;HeaderMarginInch / FooterMarginInch 控制的是页眉页脚与正文之间的距离,和四周边距是两回事,不要混用。
3. 打印区域
PrintArea 用标准 Excel 区域写法,例如 "A1:D5"。只想打印某一块时用它,比隐藏行列省事。
4. 重复标题行
PrintTitleRows 的格式是 "$起始行:$结束行","$1:$1" 表示每页都重复第 1 行。长表跨页时这个设置几乎是必加的。对应的 PrintTitleColumns 用 "$A:$A" 这类写法控制重复列。
5. 缩放
FitToPagesWide 和 FitToPagesTall 都设成 1,意思是“不管内容多少,压到一页宽一页高”。注意这会让内容整体缩小,字太小时要权衡。
6. 页眉页脚占位符
页眉页脚字符串里支持一批占位符,常用的有:
&P 当前页码
&N 总页数
&D 当前日期
&T 当前时间
&"字体名"&字号 指定字体和字号
&B 加粗
&I 斜体
所以 ps.LeftHeader 可以写成 '&"微软雅黑"&12 区域销售明细',页脚可以写成 "第 &P 页 / 共 &N 页",打印时页码和总页数会自动填充。
四、几个不常用但很实用的打印开关
除了上面那些“大项”,还有一些开关在特定场景下很有用,比如内部核对用的表想打印网格线、打印批注,或者赶时间用草稿质量输出。
- from spire.xls import Workbook, PrintCommentType, PrintErrorsType
- from spire.xls.common import ExcelVersion
- 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 页面属性,流程其实是固定的几步:
1. 拿到工作簿:新建用 Workbook(),读取已有文件用 LoadFromFile();
2. 定位工作表:wb.Worksheets[索引];
3. 取 PageSetup:ws.PageSetup,这是所有页面属性的入口;
4. 按需设属性:纸张、方向、边距、区域、标题、居中、缩放、页眉页脚、高级开关;
5. 保存:SaveToFile(),最后调用 Dispose() 释放资源。
常用属性速查:
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:批注打印方式 / 错误值打印方式
六、适用场景与注意点
页面设置本身不难,难的是批量、统一、可复用。把纸张、方向、边距、打印区域、重复标题、缩放、页眉页脚这些属性写成代码,一次配置、到处复用,报表打印格式就能保持一致。实际使用时不必把本文所有属性都写满,按业务需要挑着用即可。
需要注意两点:一是边距单位是英寸,不是厘米,换算时别搞错;二是 FitToPagesWide / FitToPagesTall 设成 1 会强制压缩内容,字号偏小的报表要评估可读性。配合 Free Spire.XLS 本身的数据写入、格式设置、图表等功能,还可以把“生成报表 → 设置打印格式 → 输出文件”整条链路自动化。 |