MultiIndex DataFrame导出Excel时表头与数据间出现多余空行的解决方法咨询

嘿，这个坑我之前踩过，也帮不少同行解决过！确实在用xlsxwriter引擎导出带MultiIndex的DataFrame且开启merge_cells=True时，很容易出现表头和数据之间多一行空行的情况——这是因为pandas和xlsxwriter在处理多层列索引的合并单元格逻辑时，会额外预留一行导致的，不少开发者都在社区反馈过类似问题。

快速解决方法 #

你可以在导出DataFrame之后，通过xlsxwriter的工作表对象手动删除那行空行，具体步骤如下：

1. 导出DataFrame后，获取对应的工作表对象
2. 根据MultiIndex的层级数定位空行位置
3. 删除该行并保存文件

示例代码：

import pandas as pd

# 你的原有导出代码
writer = pd.ExcelWriter(out_xlsx, engine='xlsxwriter')
df1.to_excel(writer, sheet_name='All Instances', merge_cells=True)

# 获取目标工作表
worksheet = writer.sheets['All Instances']

# 计算空行位置：MultiIndex列的层级数 + 1（Excel行号从1开始计数）
header_row_count = df1.columns.nlevels
empty_row_num = header_row_count + 1

# 删除空行
worksheet.delete_rows(empty_row_num, 1)

# 保存并关闭writer
writer.close()

替代方案（按需选择） #

如果你不想手动处理空行，也可以尝试：

• 暂时关闭merge_cells=True，导出后手动在Excel里合并需要的单元格（适合数据量较小的场景）
• 用df1.reset_index()把MultiIndex转换为普通列，但这样会丢失原有的层级结构，需要根据你的需求权衡

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