使用Pandas保存DataFrame至Excel文件损坏问题排查与解决

可能原因及修复方案 #

1. 目录不存在或权限问题 #

如果目标路径C:/path/to/不存在，Python脚本不会自动创建目录，会导致文件写入不完整直接损坏；另外，脚本运行权限不足也可能导致写入中断，造成文件损坏。而Jupyter环境中可能你之前已经手动创建过该目录，或者运行权限更高。

修复：

• 写入前先创建目标目录：

  import os
  file_path = "C:/path/to/folder.xlsx"
  # 自动创建目录，已存在则不报错
  os.makedirs(os.path.dirname(file_path), exist_ok=True)
  

• 右键以管理员身份运行Python脚本，避免权限不足问题。
• 检查路径中是否包含中文、特殊字符或空格，尽量使用简洁的英文路径。

2. ExcelWriter引擎不匹配或依赖版本问题 #

pandas保存.xlsx文件需要依赖openpyxl或xlsxwriter引擎。如果Python脚本环境中默认引擎未正确安装，或与Jupyter环境的依赖版本不一致，可能导致文件格式错误。

修复：

• 显式指定ExcelWriter的引擎（推荐用openpyxl）：

  with pd.ExcelWriter("C:/path/to/folder.xlsx", engine="openpyxl") as writer:
      a_df.to_excel(writer, sheet_name="a", index=False)
      b_df.to_excel(writer, sheet_name="b", index=False)
      c_df.to_excel(writer, sheet_name="c", index=False)
  

• 统一两个环境的依赖版本，执行以下命令更新：

  pip install --upgrade pandas openpyxl
  

3. 文件被占用或写入过程中断 #

如果目标文件被Excel或其他程序打开，脚本写入时会失败；另外，脚本如果存在未捕获的异常，会导致with块无法正常执行完毕，文件未完成写入就被关闭，从而损坏。

修复：

• 保存前确保目标文件未被任何程序打开。
• 添加异常捕获，排查写入过程中的错误：

  import pandas as pd
  import os
  
  file_path = "C:/path/to/folder.xlsx"
  os.makedirs(os.path.dirname(file_path), exist_ok=True)
  
  try:
      with pd.ExcelWriter(file_path, engine="openpyxl") as writer:
          a_df.to_excel(writer, sheet_name="a", index=False)
          b_df.to_excel(writer, sheet_name="b", index=False)
          c_df.to_excel(writer, sheet_name="c", index=False)
      print("Excel文件保存成功")
  except Exception as e:
      print(f"保存失败，错误信息：{str(e)}")
  

• 检查DataFrame中是否存在异常数据（如超长文本、特殊控制字符），可通过a_df.describe()、a_df.info()排查数据格式问题。

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