Python Spire.XLS批量设置Excel边框与单元格样式

脚本专家

在批量生成或定期更新 Excel 报表时，数据准确之外，格式统一也会直接影响可读性。边框用于区分行列，字体样式用于突出重点，对齐方式让数字和文字各归其位。当这些格式需要反复设置时，用 Python 脚本统一处理比手工调整更可靠。本文以 Spire.XLS for Python 为例，整理设置单元格区域边框、创建自定义样式并套用到行列、套用 Excel 内置样式、直接设置字体属性的实现方式。

环境准备

安装 Spire.XLS 库：

2. pip install Spire.XLS

复制代码

脚本中引入模块：

2. from spire.xls import *
3. from spire.xls.common import *

复制代码

一、给单元格区域设置边框

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

2. workbook = Workbook()
3. workbook.LoadFromFile('报表.xlsx')
4. sheet = workbook.Worksheets[0]
5. # 取从首行首列到末行末列的整个数据区域
6. cr = sheet.Range[sheet.FirstRow, sheet.FirstColumn, sheet.LastRow, sheet.LastColumn]
7. # 统一设置边框线型和颜色
8. cr.Borders.LineStyle = LineStyleType.Double
9. cr.Borders.Color = Color.get_CadetBlue()
10. # 关闭对角线边框
11. cr.Borders[BordersLineType.DiagonalDown].LineStyle = LineStyleType.none
12. cr.Borders[BordersLineType.DiagonalUp].LineStyle = LineStyleType.none
13. workbook.SaveToFile('带边框.xlsx', ExcelVersion.Version2010)
14. workbook.Dispose()

复制代码

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

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

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

2. workbook = Workbook()
3. sheet = workbook.Worksheets[0]
4. # 创建一个命名样式
5. style = workbook.Styles.Add('headerStyle')
6. style.VerticalAlignment = VerticalAlignType.Center
7. style.HorizontalAlignment = HorizontalAlignType.Center
8. style.Font.Color = Color.get_Blue()
9. style.ShrinkToFit = True
10. # 在样式里定义底部边框
11. style.Borders[BordersLineType.EdgeBottom].Color = Color.get_OrangeRed()
12. style.Borders[BordersLineType.EdgeBottom].LineStyle = LineStyleType.Dotted
13. # 套用到第一列
14. sheet.Columns[0].CellStyleName = style.Name
15. sheet.Columns[0].Text = 'Test'
16. workbook.SaveToFile('列样式.xlsx', ExcelVersion.Version2010)
17. workbook.Dispose()

复制代码

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

三、套用 Excel 内置样式

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

2. workbook = Workbook()
3. workbook.LoadFromFile('报表.xlsx')
4. sheet = workbook.Worksheets[0]
5. # 把第一行套用 Title 样式
6. sheet.Range['A1:J1'].BuiltInStyle = BuiltInStyles.Title
7. workbook.SaveToFile('内置样式.xlsx', ExcelVersion.Version2010)
8. workbook.Dispose()

复制代码

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

四、直接设置字体属性

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

2. workbook = Workbook()
3. workbook.LoadFromFile('报表.xlsx')
4. sheet = workbook.Worksheets[0]
5. # 字体名称和字号
6. sheet.Range['B1'].Style.Font.FontName = 'Comic Sans MS'
7. sheet.Range['B1'].Style.Font.Size = 45
8. # 加粗、斜体、下划线
9. sheet.Range['B2:D2'].Style.Font.IsBold = True
10. sheet.Range['B3:D7'].Style.Font.IsItalic = True
11. sheet.Range['B3:B7'].Style.Font.Underline = FontUnderlineType.Single
12. # 字体颜色和删除线
13. sheet.Range['B1'].Style.Font.Color = Color.get_CornflowerBlue()
14. sheet.Range['D3'].Style.Font.IsStrikethrough = True
15. workbook.SaveToFile('字体样式.xlsx', ExcelVersion.Version2010)
16. 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() 释放资源。

总结

围绕 Spire.XLS for Python，可以用 Borders 给区域加边框，用 workbook.Styles.Add() 创建命名样式并套用到整行整列，用 BuiltInStyle 直接套用 Excel 内置样式，以及通过 Range.Style.Font 直接设置字体属性。把这些操作组合进报表生成脚本，可以让格式设置完全自动化。