使用openpyxl为Excel中DataFrame指定列数值上色时遇类型错误

openpyxl工作表行结构说明 #

• openpyxl中，工作表（Worksheet）的rows是所有行的迭代器，第1行默认对应DataFrame的表头（全为字符串类型），从第2行开始才是存储实际数据的数值行。
• 每个row是单元格（Cell）对象的元组，row[i].value对应单元格的值：表头行的单元格值都是字符串，数据行的单元格值若为数值则是int/float类型，若DataFrame中数据存为字符串则仍为字符串。

问题根源 #

你遇到的TypeError本质是两种情况：

1. 遍历过程中误包含了表头行，拿字符串表头和整数做比较，直接触发类型不兼容错误。
2. 即便跳过了表头，DataFrame的第9至最后一列可能本身是字符串类型（比如读取数据时未转换为数值），导致row[i].value为字符串，无法和整数比较。

完整解决方案 #

步骤1：确保DataFrame目标列是数值类型 #

先检查并转换第9列到最后一列的类型，避免后续比较出错：

import pandas as pd

# 假设df是你的目标DataFrame
# DataFrame列索引从0开始，第9列对应索引8
start_col_df_idx = 8
# 将目标列转换为数值类型，无法转换的值设为NaN
df.iloc[:, start_col_df_idx:] = df.iloc[:, start_col_df_idx:].apply(pd.to_numeric, errors='coerce')

步骤2：用openpyxl正确遍历数值行并上色 #

先导出DataFrame到Excel，再用openpyxl加载文件设置格式，注意跳过表头行：

from openpyxl import load_workbook
from openpyxl.styles import PatternFill

# 1. 导出DataFrame到Excel（不含索引）
df.to_excel('output.xlsx', index=False)

# 2. 加载工作簿和激活工作表
wb = load_workbook('output.xlsx')
ws = wb.active

# 定义区间对应的填充颜色（可根据需求修改）
red_fill = PatternFill(start_color='FF0000', end_color='FF0000', fill_type='solid')
yellow_fill = PatternFill(start_color='FFFF00', end_color='FFFF00', fill_type='solid')
green_fill = PatternFill(start_color='00FF00', end_color='00FF00', fill_type='solid')

# 3. 遍历目标区域：从第2行（数据行）开始，第9列到最后一列
start_row = 2  # openpyxl行号从1开始，第2行是第一行数据
start_col = 9  # openpyxl列号从1开始，对应DataFrame第9列
end_col = ws.max_column

for row in ws.iter_rows(min_row=start_row, min_col=start_col, max_col=end_col):
    for cell in row:
        # 跳过空值/NaN
        if pd.isna(cell.value):
            continue
        # 根据数值区间设置填充色
        if cell.value > 100:
            cell.fill = red_fill
        elif 50 <= cell.value <= 100:
            cell.fill = yellow_fill
        else:
            cell.fill = green_fill

# 4. 保存修改后的文件
wb.save('output_colored.xlsx')

关键注意事项 #

• openpyxl的行号、列号均从1开始，和DataFrame的0起始索引要区分：
  • DataFrame第9列 → 索引8 → openpyxl列号9
  • DataFrame第一行数据 → openpyxl行号2（行号1是表头）
• 必须先确认目标列是数值类型，否则即便跳过表头，字符串与整数的比较仍会报错。
• 使用iter_rows指定min_row和min_col可直接过滤无需处理的区域，比遍历所有行再判断更高效。

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