DataFrame写入Excel文件时列向左偏移问题排查与解决

常见原因 #

• Writer对象重复复用：如果同一个ExcelWriter对象被多次写入同一个工作表，或者该工作表之前已有内容，后续写入会从已占用的下一列开始，造成整体内容左偏的视觉效果。
• 手动写入操作干扰：创建writer后若通过其他方式（如openpyxl的write方法）手动向工作表写入过内容，占用了A列位置，后续to_excel会从B列开始写入。
• 列名异常：DataFrame列名包含不可见字符或前置/后置空格，导致Excel解析列位置时出现偏移（从提供的结构看该概率较低，但可排查）。

解决方法 #

1. 使用with语句创建新Writer
   每次写入时用with语句创建独立的ExcelWriter，避免复用导致的问题，同时自动完成保存：

   import pandas as pd
   
   with pd.ExcelWriter('你的输出文件.xlsx') as writer:
       df.to_excel(writer, sheet_name=e, index=False)
   

2. 清理原有工作表后追加写入
   如果需要向已有文件的新工作表追加，先检查并删除同名工作表，再写入：

   import pandas as pd
   from openpyxl import load_workbook
   
   file_path = '你的输出文件.xlsx'
   # 加载现有工作簿，删除同名工作表
   book = load_workbook(file_path)
   if e in book.sheetnames:
       del book[e]
   book.save(file_path)
   
   # 追加写入新内容
   with pd.ExcelWriter(file_path, mode='a', engine='openpyxl') as writer:
       df.to_excel(writer, sheet_name=e, index=False)
   

3. 清理DataFrame列名
   去除列名前后的空格或不可见字符，确保列名规范：

   df.columns = df.columns.str.strip()
   

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