Styler是Pandas内置样式引擎，用于条件高亮且不修改原始数据；必须链式调用style方法并在to_excel前完成，导出需指定engine='openpyxl'；复杂逻辑须用apply自定义函数，列宽和合并单元格需openpyxl补全。
用 Styler 对 DataFrame 单元格条件高亮最直接
不用打开 Excel、不依赖 openpyxl 手动操作，Styler 是 Pandas 内置的样式引擎，专为导出带格式的 Excel 设计。它只作用于显示/导出阶段，不改变原始数据。
常见错误是试图对 to_excel() 的 workbook 或 worksheet 对象直接调用样式方法——那属于 openpyxl 的范畴，和 Styler 无关；混淆这两者会导致样式不生效或报 AttributeError: 'Styler' object has no attribute 'set_column_width' 这类错误。
实操建议：
- 先构造好 DataFrame，再链式调用
style属性（如df.style.highlight_max(axis=0)） - 所有样式方法必须在
to_excel()前完成，且to_excel()必须传入engine='openpyxl' - 若需多条件叠加（比如同时标最大值+标负数），用
.apply()或.applymap()自定义函数，别堆多个highlight_*
highlight_between() 和自定义函数处理数值区间高亮
内置的 highlight_between() 只能处理单列、单一阈值区间；遇到“销售额在 1000–5000 之间且状态为 'active'”这类复合逻辑，必须写函数传给 .apply()。
立即学习“Python免费学习笔记（深入）”；
示例：把利润列中 0–1000 的单元格标黄，超 1000 的标绿：
def color_profit(val):
if pd.isna(val):
return ''
elif 0 <= val <= 1000:
return 'background-color: yellow'
elif val > 1000:
return 'background-color: lightgreen'
else:
return ''
df.style.apply(lambda x: [color_profit(v) for v in x], subset=['profit'])
注意点：
-
subset参数限定作用列，不加会遍历全表，性能差且可能崩 - 返回空字符串
''表示“不应用样式”，不能返回None，否则报TypeError: expected str - 颜色值必须是 CSS 格式，
yellow可以，Yellow或YELLOW不行
导出到 Excel 后字体/边框/列宽失效？检查 engine 和 openpyxl 版本
Styler 导出的样式严重依赖 openpyxl 后端支持。用默认 xlwt（旧版）或未指定 engine，会静默丢弃所有样式，连颜色都不见。
把记录数组导出为带样式的 Excel(xlsx) 或带 BOM 的 CSV。支持列配置（表头/宽度/顺序）、表头冻结首行、斑马纹、布尔值转「是/否」、数组换行、CSV 中文防乱码。零依赖。触发词：导出 Excel、导出 CSV、记录转表格、列配置导出、数据导出、表格美化、JSON 转表格。
必须显式指定：
df.style.apply(...).to_excel('report.xlsx', engine='openpyxl')
另外，openpyxl 不支持 <code>Styler.set_properties() 中的 border 或 text-align；openpyxl >= 3.1 才能用 set_table_styles() 控制表头边框。如果发现 set_properties(**{'border': '1px solid black'}) 没反应，先运行 pip install --upgrade openpyxl。
列宽控制不是靠 Styler，而要导出后用 openpyxl 补充设置：
with pd.ExcelWriter('report.xlsx', engine='openpyxl') as writer:
df.style.apply(...).to_excel(writer, index=False)
worksheet = writer.sheets['Sheet1']
worksheet.column_dimensions['A'].width = 20
合并单元格 + 条件样式？别用 Styler，换 openpyxl 直接操作
Styler 完全不支持合并单元格（merge_cells）。如果报表需要“按部门合并 A 列 + 部门内高亮超标项”，就得放弃链式 style，改用 openpyxl 手动写入。
典型流程是：先用 to_excel() 导出基础数据（不带样式），再用 openpyxl.load_workbook() 打开，定位坐标、合并、设填充色、加边框。
容易被忽略的细节：
- openpyxl 的行列索引从 1 开始（
ws.cell(row=1, column=1)），而 Pandas DataFrame 索引从 0 开始，需手动 +1 - 合并前必须确保目标区域内容一致，否则 Excel 会警告“仅左上角单元格保留值”
- 条件样式若涉及公式（如
=B2>1000），要用add_conditional_formatting()，不能靠cell.fill
真要混合使用，Styler 负责简单高亮，复杂排版交给 openpyxl 补刀——两者不是替代关系，而是分工关系。
