查看: 110|回复: 3

Python批量设置Excel打印布局:PageSetup属性详解

[复制链接]
发表于 半小时前 | 显示全部楼层 |阅读模式
做报表的人大概都遇到过这类情况:销售表打印出来右边两列被截断,财务表每页都缺表头,页边距忽大忽小装订后文字被压住。逐份手动调页面设置既费时又容易漏项。本文用 Python 把这些设置写成代码,一次配置、批量复用,让所有报表的打印格式保持一致。

下面以 Free Spire.XLS for Python 为例,从纸张、方向、边距,到打印区域、重复标题行、缩放、页眉页脚,再到几个不常用的打印开关,完整梳理一遍 PageSetup 的用法。

一、为什么把页面设置交给代码

Excel 的页面设置项很多:纸张、方向、边距、打印区域、重复标题、缩放、页眉页脚等。手动调一份不难,难的是几十上百份报表都调成一致。改用代码处理的好处很直接:

1. 格式统一,不会出现这份 A4 横向、那份 Letter 纵向的混搭;
2. 批量处理时不会漏设某一项;
3. 设置逻辑可以复用,下次换数据源直接跑。

所有打印相关的属性都挂在 ws.PageSetup 这个对象上。先把这一点记住,后面的代码本质上就是往它身上挂不同的属性。

二、安装与最小示例

安装命令:
  1. pip install spire.xls.free
复制代码

先看一个最小可运行例子,感受 API 的调用方式:
  1. from spire.xls import Workbook, PaperSizeType, PageOrientationType
  2. from spire.xls.common import ExcelVersion
  3. wb = Workbook()
  4. ws = wb.Worksheets[0]
  5. ws.Name = "示例页"
  6. ps = ws.PageSetup
  7. ps.PaperSize = PaperSizeType.PaperA4          # A4 纸
  8. ps.Orientation = PageOrientationType.Landscape # 横向
  9. wb.SaveToFile("minimal.xlsx", ExcelVersion.Version2013)
  10. wb.Dispose()
复制代码

这段代码只做了两件事:把纸张设成 A4,把方向设成横向。其余属性保持默认,保存为 xlsx 即可。

三、一次性配置常用页面属性

下面用一个“区域销售明细”的场景,把最常用的页面属性一次性配好。示例用字典列表写数据,和直接写二维列表的做法区分开,但覆盖的设置项是一致的。
  1. from spire.xls import *
  2. from spire.xls.common import ExcelVersion
  3. wb = Workbook()
  4. ws = wb.Worksheets[0]
  5. ws.Name = "区域销售明细"
  6. # ---- 写入表头 ----
  7. col_titles = ["区域", "品类", "金额(万)", "毛利率"]
  8. for c, title in enumerate(col_titles, 1):
  9.     ws.Range[1, c].Text = title
  10. # ---- 写入明细 ----
  11. rows = [
  12.     {"区域": "华东", "品类": "笔记本", "金额(万)": 120, "毛利率": "15%"},
  13.     {"区域": "华东", "品类": "平板", "金额(万)": 85, "毛利率": "12%"},
  14.     {"区域": "华北", "品类": "笔记本", "金额(万)": 95, "毛利率": "13%"},
  15.     {"区域": "华北", "品类": "平板", "金额(万)": 70, "毛利率": "10%"},
  16.     {"区域": "华南", "品类": "笔记本", "金额(万)": 110, "毛利率": "14%"},
  17.     {"区域": "华南", "品类": "平板", "金额(万)": 90, "毛利率": "11%"},
  18. ]
  19. for r, item in enumerate(rows, start=2):
  20.     ws.Range[r, 1].Value = item["区域"]
  21.     ws.Range[r, 2].Value = item["品类"]
  22.     ws.Range[r, 3].Value = str(item["金额(万)"])
  23.     ws.Range[r, 4].Value = item["毛利率"]
  24. ps = ws.PageSetup
  25. # 纸张与方向
  26. ps.PaperSize = PaperSizeType.PaperA4
  27. ps.Orientation = PageOrientationType.Landscape
  28. # 四周边距(英寸)
  29. ps.TopMargin = 1.2
  30. ps.BottomMargin = 1.2
  31. ps.LeftMargin = 0.8
  32. ps.RightMargin = 0.8
  33. ps.HeaderMarginInch = 0.4
  34. ps.FooterMarginInch = 0.4
  35. # 只打印 A1:D5 这一块
  36. ps.PrintArea = "A1:D5"
  37. # 第 1 行作为重复标题行
  38. ps.PrintTitleRows = "$1:$1"
  39. # 内容在页面上居中
  40. ps.CenterHorizontally = True
  41. ps.CenterVertically = True
  42. # 缩放到一页宽、一页高
  43. ps.FitToPagesWide = 1
  44. ps.FitToPagesTall = 1
  45. # 页眉页脚
  46. ps.LeftHeader = '&"微软雅黑"&12 区域销售明细'
  47. ps.CenterFooter = "第 &P 页 / 共 &N 页"
  48. ps.RightFooter = "生成日期:&D"
  49. ws.Range.AutoFitColumns()
  50. wb.SaveToFile("sales_pagesetup.xlsx", ExcelVersion.Version2013)
  51. 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 页",打印时页码和总页数会自动填充。

四、几个不常用但很实用的打印开关

除了上面那些“大项”,还有一些开关在特定场景下很有用,比如内部核对用的表想打印网格线、打印批注,或者赶时间用草稿质量输出。
  1. from spire.xls import Workbook, PrintCommentType, PrintErrorsType
  2. from spire.xls.common import ExcelVersion
  3. wb = Workbook()
  4. ws = wb.Worksheets[0]
  5. ws.Name = "指标核对"
  6. ws.Range[1, 1].Text = "指标"
  7. ws.Range[1, 2].Text = "数值"
  8. ws.Range[1, 3].Text = "单位"
  9. metrics = [("总销售额", 150000, "元"),
  10.            ("平均订单额", 2500, "元"),
  11.            ("客户数", 1200, "人"),
  12.            ("转化率", 0.15, "%")]
  13. for r, (name, val, unit) in enumerate(metrics, start=2):
  14.     ws.Range[r, 1].Value = name
  15.     ws.Range[r, 2].NumberValue = val
  16.     ws.Range[r, 3].Value = unit
  17. ps = ws.PageSetup
  18. ps.IsPrintGridlines = True           # 打印网格线
  19. ps.IsPrintHeadings = True            # 打印行号列标
  20. ps.BlackAndWhite = True              # 黑白输出
  21. ps.Draft = True                      # 草稿质量,速度快
  22. ps.PrintComments = PrintCommentType.InPlace  # 批注打印在原位置
  23. ps.PrintErrors = PrintErrorsType.NA          # 错误值显示为 N/A
  24. ws.Range.AutoFitColumns()
  25. wb.SaveToFile("metrics_print.xlsx", ExcelVersion.Version2013)
  26. 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 本身的数据写入、格式设置、图表等功能,还可以把“生成报表 → 设置打印格式 → 输出文件”整条链路自动化。
回复

使用道具 举报

发表于 半小时前 | 显示全部楼层

Re: Python批量设置Excel打印布局:PageSetup属性详解

这篇整理得很实用,正好把报表打印时常见的纸张方向不统一、边距忽大忽小、每页缺表头这些痛点串起来了。把打印相关设置集中到 ws.PageSetup 上,再配合批量脚本复用,确实比逐份手动调省心,也不容易漏项。 最小示例和区域销售明细示例的层次安排挺好,先让人看懂调用方式,再一次性覆盖纸张、方向、边距、打印区域、重复标题行、居中和缩放,照着搭一个模板就能用。页眉页脚那段虽然正文没完整显示,但前面的配置思路已经比较清楚了。实际批量跑之前,建议先拿一份样表确认打印区域和重复标题行是否符合预期,再套到全部报表上。
回复 支持 反对

使用道具 举报

发表于 半小时前 | 显示全部楼层

Re: Python批量设置Excel打印布局:PageSetup属性详解

楼主这篇整理得很实用,PageSetup 集中配置的思路很清楚,尤其把纸张方向、四周边距、打印区域、重复标题行、居中和缩放放在一个场景里串起来,比零散记属性更容易上手。实际批量处理报表时,确实建议先把这些常用项封装成固定函数,再按不同报表类型传参,能减少漏设。 另外看正文到页眉页脚部分好像还没展开,页眉页脚的字符串语法通常比较绕,尤其引号和字体设置,建议后续可以补充几个可直接运行的完整示例。还有 PrintArea 和 PrintTitleRows 的字符串格式、FitToPagesWide 与 FitToPagesTall 同时设置时的效果,也值得再提醒一下,避免大家照抄后打印范围或缩放不符合预期。整体内容对做批量报表打印的人挺有帮助。
回复 支持 反对

使用道具 举报

发表于 半小时前 | 显示全部楼层

Re: Python批量设置Excel打印布局:PageSetup属性详解

这篇整理挺实用的,尤其是把纸张、方向、边距、打印区域、重复标题行、居中和缩放这些常用项放进一个“区域销售明细”的完整场景里,代码改改就能套到自己的报表上。批量处理报表最怕格式不统一,统一通过 PageSetup 配置确实省事,也比逐份手动调更不容易漏项。 不过页眉页脚那段好像没贴完整,LeftHeader 后面的内容断掉了,期待补全。另外后面如果能把多工作表批量复用的写法也顺带说一下,比如遍历 Worksheets 统一设置,就更完整了。
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

指导单位

江苏省公安厅

江苏省通信管理局

浙江省台州刑侦支队

DEFCON GROUP 86025

Hacking Group 021A

旗下站点

态势感知中心

应急响应中心

红盟安全

联系我们

官方QQ群:112851260

官方邮箱:security#ihonker.org(#改成@)

官方核心成员

关注微信公众号

Archiver|手机版|小黑屋| ( 沪ICP备2021026908号 )

GMT+8, 2026-11-19 02:47 , Processed in 0.025143 second(s), 18 queries , Gzip On, Redis On.

Powered by ihonker.com

Copyright © 2015-现在.

  • 返回顶部