使用df.to_excel导出多级索引DataFrame时Excel文件损坏求助

• 检查多级索引层级的命名
  多级索引的层级名称若包含特殊字符（如换行、斜杠）或为空，会导致Excel解析失败。先重置索引名称再导出：

  # 根据实际层级数量调整名称
  df.index.names = ['一级索引', '二级索引']
  df.to_excel('result.xlsx', index=True)
  

• 转换多级索引为普通列后导出
  部分Excel引擎对多级索引支持有限，可先将索引转为列：

  # 扁平化索引为普通列
  df_flat = df.reset_index()
  df_flat.to_excel('result_flat.xlsx', index=False)
  

• 指定兼容的Excel引擎与格式
  明确使用支持xlsx格式的引擎，避免老旧格式的兼容性问题：

  # 使用openpyxl引擎导出标准xlsx文件
  df.to_excel('result.xlsx', engine='openpyxl', index=True)
  

• 清理DataFrame中的特殊数据类型
  如果DataFrame包含复杂对象（如列表、字典）或非标准空值，先转换为Excel支持的类型：

  # 将复杂类型转为字符串，统一空值为NaN
  df = df.applymap(lambda x: str(x) if isinstance(x, (list, dict)) else x)
  df = df.fillna(pd.NA)
  df.to_excel('result_clean.xlsx', index=True)
  

• 捕获导出异常排查问题
  导出时捕获异常，确认是否有静默错误导致文件损坏：

  import pandas as pd
  try:
      df.to_excel('result.xlsx', index=True)
      print("文件导出成功")
  except Exception as e:
      print(f"导出失败原因: {str(e)}")
  

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