首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >Python 自动化 Excel 打印布局:用代码精细控制页面设置

Python 自动化 Excel 打印布局:用代码精细控制页面设置

原创
作者头像
用户12495000
修改于 2026-11-18 15:10:12
修改于 2026-11-18 15:10:12
150
举报

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

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

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

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

本文使用 Free Spire.XLS for Python 来演示,覆盖从基础纸张设置到页眉页脚、高级打印选项的完整流程。

一、安装与最小示例

代码语言:javascript
复制
pip install spire.xls.free

先看一个最小可运行例子,感受一下 API 的调用方式:

代码语言:javascript
复制
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。后面所有打印相关的属性——纸张、方向、边距、区域、标题、缩放、页眉页脚——都挂在这个对象上。先把这一点记住,后面的代码就只是往它身上挂不同属性而已。

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

下面用一个"区域销售明细"的场景,把最常用的页面属性一次性配好。注意这版代码的变量命名、数据结构和原文不同,但覆盖的设置项是一致的。

代码语言:javascript
复制
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

加粗 / 斜体

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

除了上面这些"大项",还有一些开关在特定场景下很有用,比如内部核对用的表想打印网格线、打印批注、或者赶时间用草稿质量。

代码语言:javascript
复制
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 页面属性的流程其实是固定的几步:

  1. 拿到工作簿 :新建用 Workbook(),读现有文件用 LoadFromFile()。
  2. 定位工作表 :wb.Worksheets[索引]。
  3. 取 PageSetup :ws.PageSetup,这是所有页面属性的入口。
  4. 按需设属性 :纸张、方向、边距、区域、标题、居中、缩放、页眉页脚、高级开关。
  5. 保存 :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 删除。

目录
  • 为什么要把页面设置交给代码
  • 一、安装与最小示例
  • 二、一次性配置常用页面属性
  • 三、几个不常用但很实用的打印开关
  • 四、整体流程与属性速查
  • 小结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档