使用pandas导出带条件格式的Excel时出现AttributeError错误的技术咨询

• 引擎与API不匹配：代码指定pandas写入引擎为xlsxwriter，但调用的是openpyxl库专属的conditional_formatting属性和规则类，两个库为独立维护的Excel操作组件，对象属性互不通用，直接触发属性不存在的报错。
• 代码逻辑缺失：后续使用的worksheet、color_scale_rule未提前赋值，调用workbook.save的保存逻辑不符合xlsxwriter引擎的交互要求。
• 冗余导入：开头导入了大量未实际使用的openpyxl模块，增加不必要的运行依赖。

路径1：基于现有xlsxwriter引擎实现（适配pandas导出场景） #

不需要额外切换依赖，直接使用xlsxwriter原生的条件格式API，即可实现根据数值大小自动匹配红、黄、绿色阶的效果，完整可运行代码如下：

import pandas as pd

# 构造测试数据集
df = pd.DataFrame({'Data': [10, 20, 30, 20, 15, 30, 45]})

# 初始化Excel写入器，指定xlsxwriter引擎
writer = pd.ExcelWriter('export_with_conditional_format.xlsx', engine='xlsxwriter')
df.to_excel(writer, sheet_name='Sheet1', index=False)

# 获取工作簿和工作表对象
workbook = writer.book
worksheet = writer.sheets['Sheet1']

# 定义三阶色阶规则，匹配红-黄-绿的颜色映射效果
color_scale_rule = {
    'type': '3_color_scale',
    'min_color': '#AA0000',
    'mid_color': '#FFFF00',
    'max_color': '#00AA00'
}

# 给目标单元格范围添加条件格式，范围需匹配实际数据的位置
worksheet.conditional_format('A2:A8', color_scale_rule)

# 完成写入并保存文件
writer.close()

注意：xlsxwriter的工作表不存在conditional_formatting属性，对应添加条件格式的方法为conditional_format，规则以字典形式传入即可。如果需要给O列对应范围加规则，只需将方法中的范围字符串替换为O2:O295。

路径2：切换openpyxl引擎实现 #

如果需要使用openpyxl的规则类语法，必须将pandas的写入引擎切换为openpyxl，否则依然会出现API不兼容的报错，完整可运行代码如下：

import pandas as pd
from openpyxl.formatting.rule import ColorScaleRule

# 构造测试数据集
df = pd.DataFrame({'Data': [10, 20, 30, 20, 15, 30, 45]})

# 初始化Excel写入器，切换为openpyxl引擎
writer = pd.ExcelWriter('export_openpyxl_conditional.xlsx', engine='openpyxl')
df.to_excel(writer, sheet_name='Sheet1', index=False)

# 获取工作表对象，此时openpyxl的工作表自带conditional_formatting属性
ws = writer.sheets['Sheet1']

# 定义三阶色阶规则
color_scale_rule = ColorScaleRule(
    start_type='min', start_color='AA0000',
    mid_type='percentile', mid_value=50, mid_color='FFFF00',
    end_type='max', end_color='00AA00'
)

# 添加条件格式到目标范围
ws.conditional_formatting.add('A2:A8', color_scale_rule)

# 完成写入并保存
writer.close()

• 条件格式的应用范围要和实际数据位置匹配，避免把表头行纳入格式范围导致样式错位。
• 使用pandas的ExcelWriter写文件时，必须调用writer.close()完成缓存写入，直接调用底层库的save方法容易生成损坏的Excel文件。

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