保存带索引的空Pandas DataFrame到Excel为何触发索引越界错误？

嘿，这个问题我之前在项目里也踩过坑！本质上是xlsxwriter引擎在处理空的多级索引DataFrame时的兼容性问题，咱们来一步步拆解问题和解决办法：

问题根源 #

你创建的df是一个没有任何行数据的多级索引DataFrame，当用xlsxwriter引擎执行to_excel时，引擎会尝试访问索引的行数据来生成Excel的表头结构，但因为DataFrame完全是空的，索引的内部数组长度为0，就触发了index 0 is out of bounds的错误。

两种可行的解决办法 #

1. 切换到openpyxl引擎（推荐）

openpyxl对空的多级索引DataFrame的处理更加友好，不需要修改DataFrame结构，只需要更换引擎即可：

# 确保已经安装openpyxl：pip install openpyxl
Writer = pd.ExcelWriter(
    OutputBaseDir + EnvPrefix + '{}_topup.xlsx'.format(ProcessingCompartment),
    engine='openpyxl'
)
df.to_excel(Writer, sheet_name='topup')
Writer.save()

2. 临时添加一行空数据（如果必须用xlsxwriter）

如果因为环境限制不能更换引擎，可以给空DataFrame临时添加一行空数据，让xlsxwriter有数据可以处理，写入后的Excel会保留你需要的索引和列结构：

# 构造一行空的多级索引数据
empty_row = pd.DataFrame(
    [None], 
    columns=['c'],
    index=pd.MultiIndex.from_tuples([(None, None)], names=['a', 'b'])
)
# 合并到原DataFrame
df = pd.concat([df, empty_row])

# 正常写入Excel
Writer = pd.ExcelWriter(
    OutputBaseDir + EnvPrefix + '{}_topup.xlsx'.format(ProcessingCompartment),
    engine='xlsxwriter'
)
df.to_excel(Writer, sheet_name='topup')
Writer.save()

如果后续不需要这行空数据，也可以在写入后重新读取Excel并删除该行，但如果只是需要保留表头和索引结构，这行空数据通常不会影响使用。

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