如何用openpyxl提取单元格精确颜色？返回值存在不一致问题

阿华AIGC实验室

2026-5-7

解决OpenPyXL提取单元格填充颜色的不一致问题

我来帮你梳理这个问题，你遇到的情况其实是OpenPyXL对Excel两种颜色类型的不同处理方式导致的，还有默认样式的干扰，咱们一步步解决：

为什么返回值有时是字符串有时是整数？

Excel里的填充颜色分两种核心类型，OpenPyXL会对应返回不同格式的值：

自定义RGB颜色：当你手动选择了非默认调色板的颜色（比如自定义的紫色、亮蓝色），start_color.index会返回8位十六进制字符串（比如FFFFFF00，前两位是透明度，后六位是RGB值）。
索引调色板颜色：当你用的是Excel内置的索引颜色表（比如调色板里的第9个预设色），会返回对应的整数索引（比如9、1）。
默认/无填充：没有设置填充色的单元格，通常会返回0或者64，这是OpenPyXL对Excel默认样式的标记。

完整的颜色转换解决方案

你需要一个更完善的转换函数，不仅要处理索引和RGB的转换，还要区分无填充的情况，同时用OpenPyXL自带的颜色映射来避免错误：

首先导入OpenPyXL的颜色模块：

from openpyxl.styles.colors import COLOR_INDEX

然后替换你的转换函数：

def get_cell_fill_color(cell):
    fill = cell.fill
    # 先判断是否是纯色填充（排除渐变、图案填充或无填充）
    if fill.fill_type != 'solid':
        return None  # 用None标记非纯色填充的情况
    
    color_index = fill.start_color.index
    # 处理RGB字符串的情况，提取标准6位RGB（可保留透明度如果需要）
    if isinstance(color_index, str):
        return color_index[-6:] if len(color_index) == 8 else color_index
    # 处理索引颜色的情况，用内置调色板映射
    elif isinstance(color_index, int):
        if 0 <= color_index < len(COLOR_INDEX):
            return COLOR_INDEX[color_index]
        else:
            return str(color_index)
    # 其他异常情况
    else:
        return None

使用示例：

import openpyxl
from openpyxl.styles.colors import COLOR_INDEX

def get_cell_fill_color(cell):
    # 上面的函数代码
    pass

wb = openpyxl.load_workbook('csv_file/demo.xlsx')
ws = wb['Sheet1']

# 批量提取颜色并生成新列
for row in range(1, ws.max_row + 1):
    cell = ws[f'A{row}']
    color = get_cell_fill_color(cell)
    # 把颜色值写入B列对应行
    ws[f'B{row}'] = color

wb.save('csv_file/demo_with_color.xlsx')