Pandas DataFrame Styler的relabel_index导出Excel不生效问题

问题根源 #

Pandas的Styler是视图渲染层工具，relabel_index仅修改HTML/PDF这类依赖Styler渲染的输出显示逻辑，不会改动原始DataFrame的列索引结构。而Excel导出（to_excel）直接读取原始DataFrame的元数据，自然不会应用Styler的修改。

实现数据与输出分离的解决方案 #

核心思路：原始DataFrame保持不变，针对不同输出格式做针对性本地化处理，统一管理本地化映射规则。

1. 统一管理本地化映射

先定义全局的本地化名称映射，方便所有输出复用：

import pandas as pd

# 原始数据（始终保持原始状态，不做任何修改）
raw_df = pd.DataFrame(
    [[10, 20], [30, 40]],
    columns=pd.MultiIndex.from_tuples([('english_col1', 'sub_col1'), ('english_col2', 'sub_col2')])
)

# 本地化映射表（集中管理，修改一次同步所有输出）
localized_map = {
    'english_col1': '地区销售额',
    'english_col2': '地区利润'
}

2. HTML/PDF输出：继续使用Styler

保留原有Styler逻辑，因为HTML和PDF依赖其渲染能力：

# 生成带本地化索引的Styler对象
styled_df = raw_df.style.relabel_index(localized_map, level=0)

# 导出HTML
styled_df.to_html('localized_report.html')

# 导出PDF（需提前安装weasyprint：pip install weasyprint）
from weasyprint import HTML
HTML(string=styled_df.to_html()).write_pdf('localized_report.pdf')

3. Excel输出：临时修改DataFrame副本

创建原始DataFrame的副本，修改副本列索引后导出，完全不影响原始数据：

# 方式1：用rename直接修改指定层级的列名
excel_df = raw_df.rename(columns=localized_map, level=0)

# 方式2：针对多级索引的层级替换（更灵活）
# excel_df = raw_df.copy()
# excel_df.columns = excel_df.columns.set_levels(
#     [excel_df.columns.levels[0].map(localized_map.get), excel_df.columns.levels[1]],
#     level=[0, 1]
# )

# 导出Excel
excel_df.to_excel('localized_report.xlsx')

额外优化点 #

• 可封装批量处理函数，传入原始DataFrame和本地化映射，自动生成三种格式文件。
• 若涉及复杂样式（如单元格着色、数值格式化），可将Styler的样式规则与本地化逻辑分离，单独维护样式配置。

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