Excel 报表里,单元格背景色看似只是“美化”,实际承担着区分数据类别、提示异常值、引导阅读视线的作用。手动涂色在一次性任务中没问题,但遇到周期性报表、批量导出或数据量较大的场景,用代码来控制背景色显然更稳。下面以 Free Spire.XLS for Python 为例,整理从纯色填充到条件着色的几种常见做法,并附上几个实际使用中容易踩的细节。


环境准备

pip install spire.xls.free

导入时使用:

from spire.xls import *
from spire.xls.common import *

Free Spire.XLS for Python 不依赖本机安装 Excel,在服务器或无桌面环境中也能运行。需要留意的是,免费版对 .xls 格式的读写有工作表数量限制(每个工作簿最多 5 个,每张表最多 200 行);如果输出为 .xlsx,则不触发这一限制。本文示例统一以 .xlsx 作为输入和输出格式。


纯色填充:最直接的方式

设置单元格背景色最常用的属性是 CellRange.Style.Color:

from spire.xls import *
from spire.xls.common import *

workbook = Workbook()
workbook.LoadFromFile("input.xlsx")

sheet = workbook.Worksheets[0]

# 表头行填充绿色
sheet.Range["A1:G1"].Style.Color = Color.get_Green()

# 单个单元格填充黄色
sheet.Range["A6"].Style.Color = Color.get_Yellow()

workbook.SaveToFile("output_solid.xlsx", ExcelVersion.Version2016)
workbook.Dispose()

Color 提供了两种指定颜色的途径:预定义命名色(如 Color.get_LightBlue()、Color.get_SteelBlue())和 RGB 数值(Color.FromRgb(144, 238, 144))。命名色写起来简洁,RGB 则在需要精确匹配品牌色或设计规范时更合适。

这里有一个值得注意的行为:给 Style.Color 赋值时,填充图案类型会自动切换为 ExcelPatternType.Solid,不需要再额外设置 Style.FillPattern。如果确实需要非纯色效果,则要通过 Interior.FillPattern 来指定:

# 125% 灰度图案
sheet.Range["A6:E10"].Style.FillPattern = ExcelPatternType.Percent125Gray

# 细对角线条纹
sheet.Range["G2"].Style.FillPattern = ExcelPatternType.ThinDiagonalStripe

渐变填充则走 Style.Interior.Gradient 路径,需先将 FillPattern 设为 Gradient,再分别指定 BackColor 和 ForeColor。不过对于大多数“设置背景色”的需求,直接使用 Style.Color 已经足够,图案和渐变更适合有明确视觉设计要求的场景。


条件着色:让颜色随数据变化

静态填充适合固定结构的报表,但如果数据行数会变化、需要按数值高低区分颜色,条件格式是更合适的选择。Free Spire.XLS 的条件格式同样支持设置背景色,核心属性是 condition.BackColor。

按单元格值着色

以下代码将 B2:B6 中大于 75 的单元格背景设为黄色:

format = sheet.ConditionalFormats.Add()
format.AddRange(sheet.Range["B2:B6"])

condition = format.AddCondition()
condition.FormatType = ConditionalFormatType.CellValue
condition.Operator = ComparisonOperatorType.Greater
condition.FirstFormula = "75"
condition.BackColor = Color.FromRgb(204, 204, 0)

FormatType = CellValue 配合 Operator 和 FirstFormula,就可以表达“大于”“小于”“介于”等常见比较规则。

按公式实现隔行变色

隔行背景色(镶边行)是财务报表和长数据表中提升可读性的常用手法。用 MOD(ROW(),2) 配合 ConditionalFormatType.Formula 即可:

conditional_format = sheet.ConditionalFormats.Add()
conditional_format.AddRange(
    sheet.Range[2, 1, sheet.LastRow, sheet.LastColumn]
)

# 偶数行:浅灰
cond_even = conditional_format.AddCondition()
cond_even.FormatType = ConditionalFormatType.Formula
cond_even.FirstFormula = "=MOD(ROW(),2)=0"
cond_even.BackColor = Color.get_LightGray()

# 奇数行:浅粉
cond_odd = conditional_format.AddCondition()
cond_odd.FormatType = ConditionalFormatType.Formula
cond_odd.FirstFormula = "=MOD(ROW(),2)=1"
cond_odd.BackColor = Color.get_LightPink()

这种写法的好处是颜色与公式绑定:后续在表格中插入或排序行,奇偶交替效果会自动保持,不需要重新执行脚本。代价是条件格式对已经存在的复杂格式或合并单元格可能有适用限制,在结构高度不规则的表格上需要先做小范围验证。

如果追求“一行代码出效果”,也可以用内置表格样式来快速获得带表头、边框和交替行色的表格对象:

table = sheet.ListObjects.Create("table", cellRange)
table.BuiltInTableStyle = TableBuiltInStyles.TableStyleMedium2

BuiltInTableStyle 自带带状行效果,且新插入行会自动继承样式;但它的灵活性不如条件格式,配色只能从内置样式中选择。


小结

Free Spire.XLS for Python 设置单元格背景色的路径大致可以归为三层:Style.Color 负责静态纯色填充,Style.FillPattern / Interior.Gradient 处理图案与渐变,condition.BackColor 则把颜色交给条件规则来控制。选择哪一种,取决于颜色是“写死的格式”还是“随数据变化的效果”。实际使用中,控制涂色范围、配好字体对比度、区分静态样式与条件格式的 API,可以避开大部分“代码没报错但颜色不对劲”的情况。