使用Pandas ExcelWriter写入时生成损坏xlsx文件的解决求助

核心原因 #

问题出在未指定正确的Excel引擎以及未正确关闭ExcelWriter对象。pandas默认的Excel引擎在处理.xlsx文件时，若不指定engine='openpyxl'，可能导致文件写入不完整或格式损坏；另外，未显式关闭writer或使用上下文管理器，会造成文件流未正常刷新，引发损坏。

解决方案步骤 #

• 安装依赖库：追加模式需要openpyxl支持，先确保已安装：

  pip install openpyxl
  

• 显式指定引擎并使用上下文管理器：始终用with语句管理ExcelWriter，确保文件流正确关闭。
  • 新建文件（避免直接初始化ExcelWriter不关闭的问题）：

    import pandas as pd
    from pandas import ExcelWriter
    
    df = pd.DataFrame([1, 2, 3])
    with ExcelWriter("test.xlsx", engine='openpyxl') as writer:
        df.to_excel(writer)
    

  • 追加数据到已有文件（覆盖同工作表数据）：

    import pandas as pd
    from pandas import ExcelWriter
    
    df_new = pd.DataFrame([4, 5, 6])
    with ExcelWriter("test.xlsx", mode='a', if_sheet_exists="overlay", engine='openpyxl') as writer:
        df_new.to_excel(writer, index=False, header=False)  # 根据需求设置index和header
    

  • 追加数据到新工作表：

    with ExcelWriter("test.xlsx", mode='a', engine='openpyxl') as writer:
        df_new.to_excel(writer, sheet_name='新工作表')
    

• 版本兼容检查：确保pandas（>=1.4.0）和openpyxl（>=3.0.0）版本匹配，过旧版本可能存在bug。
• 排查其他干扰：确保文件未被Excel或其他程序占用，文件路径不含特殊字符（如中文空格、特殊符号）。

关键注意事项 #

• 不要直接初始化ExcelWriter后不关闭（如writer = ExcelWriter(...)后未调用writer.close()），必须用with上下文管理器或手动调用writer.close()。
• .xls格式不支持追加模式，若使用旧格式需改用其他方法（如读取原文件合并后再写入）。

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