MultiIndex列导出Excel只显示最后一层表头，是因为默认扁平化写入导致多级表头被压在同一行；需用openpyxl引擎、将MultiIndex设为columns、从第0行列开始写入，并确保层级数组长度一致。
MultiIndex生成后直接to_excel为什么只导出最后一层表头？
因为默认情况下 to_excel 会把 MultiIndex 的所有层级都写入 Excel 的同一行（即“扁平化”写入），但 Excel 表头行只能显示一层——实际是底层索引被覆盖了，上层索引看似“消失”。本质不是没导出，而是被 openpyxl 或 xlsxwriter 渲染时压到了同一行，视觉上只剩最内层。
解决的关键是：必须让 to_excel 明确知道哪些列属于多级表头，并预留足够行数。这依赖两个配合动作：
- 用
pd.MultiIndex.from_tuples()或pd.MultiIndex.from_arrays()构造带层级的列索引（columns），而非行索引（index） - 调用
to_excel时传入header=True（默认）且不手动设置startrow，否则会错位 - 确保底层引擎支持多级表头：推荐用
engine='openpyxl'（xlsxwriter对多级列头支持弱，可能报NotImplementedError: Writing to Excel with MultiIndex columns is not yet supported）
如何构造适合Excel多表头的MultiIndex列结构？
Excel 多表头本质是“跨列合并”，而 MultiIndex 的层级对应 Excel 中从上到下的表头行。所以你要按“上层→下层”顺序组织元组或数组，例如：
import pandas as pd
arrays = [
['销售', '销售', '库存', '库存'],
['金额', '数量', '当前', '预警']
]
columns = pd.MultiIndex.from_arrays(arrays, names=['大类', '小类'])
df = pd.DataFrame([[100, 5, 200, 10], [120, 6, 180, 15]], columns=columns)
注意：names 参数会作为最顶层表头（第 0 行），若不设则只输出层级内容，无命名行；若设了但数据中某列未覆盖全部层级，Excel 里会出现空单元格，后续合并需手动处理。
立即学习“Python免费学习笔记（深入）”；
常见错误：
诊断并修复涉及公式、命名范围、Power Query 刷新、数据透视表、VBA/宏保存等问题的 Microsoft Excel XLSX 工作簿
- 用
pd.MultiIndex.from_product()生成笛卡尔积，导致列数爆炸，远超实际需要 - 层级数组长度不一致（如第一层 4 个元素，第二层 3 个），直接抛
ValueError - 把
MultiIndex设在index上却想导出多列头——那导出的是行方向的多级索引，Excel 里表现为多行左侧标签，不是顶部表头
to_excel导出时怎么避免表头错位或截断？
错位主因是写入起点偏移或引擎兼容性。正确做法：
- 显式指定
engine='openpyxl'，并提前安装：pip install openpyxl - 不要用
startrow=1或startcol=1，除非你手动画表头——多级列头必须从第 0 行、第 0 列开始写，否则层级对不齐 - 若 DataFrame 本身有行索引（
index=True），它会占据最左列，多级列头从第 1 列开始，此时 Excel 表头行数 =MultiIndex.nlevels，左侧行索引列不会影响顶部列头渲染 - 导出后打开 Excel，检查是否自动合并了同名上层单元格（如两个“销售”自动跨两列）——这是 openpyxl 的默认行为，无需额外操作
示例调用：
df.to_excel('report.xlsx', engine='openpyxl', index=False)
导出后发现Excel里上层表头文字挤在一起或换行异常？
这是 Excel 自身格式问题，不是 Pandas 导出失败。openpyxl 写入时只写入文本和层级结构，不设置单元格宽度、自动换行或合并样式。用户常误以为“导出没成功”，其实是没做后续格式适配。
如果必须自动化美化，可在导出后用 openpyxl 补充样式（注意：不能在 to_excel 过程中直接操作，需另开工作簿）：
- 加载刚生成的文件：
wb = openpyxl.load_workbook('report.xlsx') - 获取 active sheet：
ws = wb.active - 遍历第 1 行（
ws[1]）和第 2 行（ws[2]），对相同上层值的连续列执行ws.merge_cells() - 设置
alignment=Alignment(wrap_text=True)和列宽：ws.column_dimensions['A'].width = 12
但多数报表场景建议导出后人工微调——因为自动合并逻辑复杂（需识别层级归属、处理空 name、应对动态列数），投入产出比低。真正关键的，是确保数据结构和层级定义准确，Excel 至少能看清字段归属。
最容易被忽略的一点：如果你用 groupby(...).agg(...) 生成了 MultiIndex 列，记得调用 .reset_index(drop=True) 清掉可能残留的行索引干扰，再导出。
