使用openpyxl读取应用ColorScaleRule的单元格背景填充色异常问题

你遇到的现象是预期内的，应用了ColorScaleRule等条件格式的单元格，确实无法直接通过cell.fill属性读取到实际显示的填充色，核心原因如下：

• 单元格的fill.fgColor、fill.bgColor仅存储手动设置的静态填充样式，条件格式属于Excel的动态渲染规则，仅存储规则本身，规则生效后的最终填充色是Excel打开文件时实时计算生成的，不会写入单元格的基础属性。
• openpyxl仅支持读写条件格式的规则配置，不会自动模拟Excel的渲染逻辑计算规则应用后的实际填充色。

解决方法 #

你需要自行读取作用在目标单元格上的色阶规则，根据单元格数值手动插值计算对应的RGB色值，示例实现如下：

from openpyxl import Workbook
from openpyxl.formatting.rule import ColorScaleRule

# 十六进制颜色转RGB元组，自动忽略ARGB格式的透明度位
def hex_to_rgb(hex_str):
    hex_str = hex_str.lstrip('#')[-6:]
    return tuple(int(hex_str[i:i+2], 16) for i in (0, 2, 4))

# RGB元组转回十六进制字符串
def rgb_to_hex(rgb):
    return f'{rgb[0]:02X}{rgb[1]:02X}{rgb[2]:02X}'

# 按色阶规则计算当前值对应的填充色
def calc_colorscale_color(cell_value, start_val, end_val, start_color, end_color):
    # 计算当前值在区间内的占比，限制在0~1区间避免越界
    ratio = max(0, min(1, (cell_value - start_val) / (end_val - start_val)))
    s_rgb = hex_to_rgb(start_color)
    e_rgb = hex_to_rgb(end_color)
    # 分别对RGB三个通道做线性插值
    cur_r = int(s_rgb[0] + (e_rgb[0] - s_rgb[0]) * ratio)
    cur_g = int(s_rgb[1] + (e_rgb[1] - s_rgb[1]) * ratio)
    cur_b = int(s_rgb[2] + (e_rgb[2] - s_rgb[2]) * ratio)
    return rgb_to_hex((cur_r, cur_g, cur_b))

# 原有业务代码
wb1 = Workbook()
ws1 = wb1.create_sheet('new sheet', 0)
target_cell = ws1.cell(1,1)
target_cell.value = 0.5

rule = ColorScaleRule(start_type='num', start_value=0, start_color='FFFFFF',
                      end_type='num', end_value=1, end_color='FF007F')
ws1.conditional_formatting.add(range_string='A1', cfRule=rule)

# 计算实际显示的填充色
cell_rgb = calc_colorscale_color(target_cell.value,
                                 rule.start_value,
                                 rule.end_value,
                                 rule.start_color,
                                 rule.end_color)
print('A1单元格实际显示的RGB值：', cell_rgb)

运行以上代码输出的RGB值和你在Excel中打开看到的浅三文鱼红色完全匹配。如果你的表格存在多个作用范围不同的条件格式规则，遍历ws1.conditional_formatting.rules判断目标单元格是否在规则的作用范围内，再取对应规则计算即可。

内容的提问来源于stack exchange，提问作者duplek