Python 设置 Excel 单元格边框与样式

报表不仅要数据准确,还要排版清晰。边框区分行列、字体样式突出重点、对齐方式让数字和文字各归其位------这些都是让 Excel 报表可读性提升的基本手段。当报表需要批量生成或定期更新时,用脚本统一设置格式比手动调整更可靠。

本文以 Spire.XLS for Python 为例,介绍如何给单元格区域设置边框、创建自定义样式并应用到整行整列、套用 Excel 内置样式,以及直接设置字体属性。

环境准备

安装 Spire.XLS 库:

bash 复制代码
pip install Spire.XLS

在脚本中引入模块:

python 复制代码
from spire.xls import *
from spire.xls.common import *

给单元格区域设置边框

最常见的需求是给一个数据区域加上统一边框。取到 CellRange 后,通过 Borders 属性批量设置:

python 复制代码
workbook = Workbook()
workbook.LoadFromFile("报表.xlsx")
sheet = workbook.Worksheets[0]

# 取从首行首列到末行末列的整个数据区域
cr = sheet.Range[sheet.FirstRow, sheet.FirstColumn, sheet.LastRow, sheet.LastColumn]

# 统一设置边框线型和颜色
cr.Borders.LineStyle = LineStyleType.Double
cr.Borders.Color = Color.get_CadetBlue()

# 关闭对角线边框
cr.Borders[BordersLineType.DiagonalDown].LineStyle = LineStyleType.none
cr.Borders[BordersLineType.DiagonalUp].LineStyle = LineStyleType.none

workbook.SaveToFile("带边框.xlsx", ExcelVersion.Version2010)
workbook.Dispose()

Borders.LineStyle 和 Borders.Color 一次性作用于区域内的所有边框。对角线默认也会被设置,如果不需要,把 DiagonalDown 和 DiagonalUp 的 LineStyle 显式置为 LineStyleType.none 即可。LineStyleType 还包括 Thin、Medium、Dotted、Dashed 等常用线型。

创建自定义样式并应用到行或列

当多行或多列需要相同的格式时,逐个单元格设置会很冗长。可以先创建一个命名样式,再把它套用到整行或整列:

python 复制代码
workbook = Workbook()
sheet = workbook.Worksheets[0]

# 创建一个命名样式
style = workbook.Styles.Add("headerStyle")
style.VerticalAlignment = VerticalAlignType.Center
style.HorizontalAlignment = HorizontalAlignType.Center
style.Font.Color = Color.get_Blue()
style.ShrinkToFit = True

# 在样式里定义底部边框
style.Borders[BordersLineType.EdgeBottom].Color = Color.get_OrangeRed()
style.Borders[BordersLineType.EdgeBottom].LineStyle = LineStyleType.Dotted

# 套用到第一列
sheet.Columns[0].CellStyleName = style.Name
sheet.Columns[0].Text = "Test"

workbook.SaveToFile("列样式.xlsx", ExcelVersion.Version2010)
workbook.Dispose()

workbook.Styles.Add() 返回的样式对象支持字体、对齐、边框、填充等全套属性。定义好后通过 CellStyleName = style.Name 应用到 sheet.Columns[i] 或 sheet.Rows[i],一行代码即可统一整列或整行。把 sheet.Columns[0] 换成 sheet.Rows[1],同样的样式就能套到第二行。

套用 Excel 内置样式

Excel 自带一批内置样式(如 Title、Heading、Good、Bad 等),可以直接套用,省去手动配色:

python 复制代码
workbook = Workbook()
workbook.LoadFromFile("报表.xlsx")
sheet = workbook.Worksheets[0]

# 把第一行套用 Title 样式
sheet.Range["A1:J1"].BuiltInStyle = BuiltInStyles.Title

workbook.SaveToFile("内置样式.xlsx", ExcelVersion.Version2010)
workbook.Dispose()

BuiltInStyles 枚举对应 Excel "开始"选项卡里"单元格样式"下拉中的那些预定义样式,适合需要与 Excel 原生外观保持一致的场景。

直接设置字体属性

如果只需要改某个区域的字体,不必创建样式对象,直接通过 Range.Style.Font 操作:

python 复制代码
workbook = Workbook()
workbook.LoadFromFile("报表.xlsx")
sheet = workbook.Worksheets[0]

# 字体名称和字号
sheet.Range["B1"].Style.Font.FontName = "Comic Sans MS"
sheet.Range["B1"].Style.Font.Size = 45

# 加粗、斜体、下划线
sheet.Range["B2:D2"].Style.Font.IsBold = True
sheet.Range["B3:D7"].Style.Font.IsItalic = True
sheet.Range["B3:B7"].Style.Font.Underline = FontUnderlineType.Single

# 字体颜色和删除线
sheet.Range["B1"].Style.Font.Color = Color.get_CornflowerBlue()
sheet.Range["D3"].Style.Font.IsStrikethrough = True

workbook.SaveToFile("字体样式.xlsx", ExcelVersion.Version2010)
workbook.Dispose()

Font 对象的属性包括 FontName、Size、IsBold、IsItalic、Underline、Color、IsStrikethrough 等,每个属性都可以独立设置。Underline 接受 FontUnderlineType 枚举(如 Single、Double、AccountingSingle)。

实用提示

  • Borders.LineStyle 作用于区域所有边框;如果只想设某一边,用 Borders[BordersLineType.EdgeBottom] 等单独指定。
  • 自定义样式定义一次可多处复用,比逐格设置效率高,也便于后续统一改版。
  • ShrinkToFit = True 让文本自动缩小以适应列宽,适合不确定内容长度的列。
  • Color.get_CadetBlue() 这类命名颜色方便记忆;也可以用 Color.FromArgb(r, g, b) 指定任意颜色。
  • 处理完调用 workbook.Dispose() 释放资源。

总结

本文介绍了用 Python 设置 Excel 单元格格式的几种方式:通过 Borders 给区域加边框、用 workbook.Styles.Add() 创建命名样式并套用到整行整列、用 BuiltInStyle 直接套用 Excel 内置样式、以及通过 Range.Style.Font 直接设置字体属性。把这些操作组合进报表生成脚本,可以让格式设置完全自动化。

相关推荐
猿究院_夏燊5 小时前
Spring Bean 生命周期
java·后端·spring
信誓旦旦的程序猿6 小时前
【Python量化实战宝典 #08】可转债与债券接口手册:转股价·溢价率·纯债价值(Python 可跑)
java·python·股票数据api·股票数据api接口·股票api数据接口·股票量化数据api·股票量化数据接口
砚底藏山河6 小时前
python量化:行情数据回溯
java·开发语言·python·金融·maven
今年下半年6 小时前
AI智能体项目实战记录(02):初始化 Python 项目
开发语言·人工智能·python·fastapi
Williamtym6 小时前
PickGo Lab实践:用浏览器、Python和MCP串起机器人搬运仿真
开发语言·python·机器人
CS创新实验室6 小时前
Python 对象“死“了之后去了哪?——引用计数与分代垃圾回收
开发语言·jvm·python
CCblandy6 小时前
雪花 ID 四个边界实测:时钟回拨重号 500 个,前端 JSON.parse 直接丢精度
后端·python·算法·性能优化·架构
我是人✓7 小时前
SpringBoot项目的五种创建方式
java·spring boot·后端
quantdash_cc7 小时前
Pandas 处理分钟级股票行情:从原始数据清洗到 K 线聚合
开发语言·python·数据分析·pandas·量化交易·股票数据·quantdash
把我格子衫拿来7 小时前
VTK 9.5 与 Qt 6 联合开发:从嵌入三维窗口到可维护的桌面架构
c++·python·qt·vtk·三维可视化