如何将Pandas DataFrame添加至现有Excel工作簿新工作表？遇覆盖或BadZipFile报错

问题原因分析 #

• 原有工作簿被覆盖：pandas.ExcelWriter默认使用'w'（写入）模式，即便加载了现有工作簿，若未正确配置模式，仍会触发文件覆盖。
• BadZipFile错误：常见诱因包括：
  • 目标文件是.xls格式（openpyxl仅支持.xlsx/.xlsm格式）
  • 文件已损坏或被其他进程（如Excel客户端）占用
  • 加载工作簿时出现异常，导致后续写入流程失败

修正后的代码 #

import pandas as pd
from openpyxl import load_workbook

# 替换为你的目标文件路径，确保是xlsx/xlsm格式
target = "你的文件路径.xlsx"

try:
    # 加载现有工作簿
    book = load_workbook(target)
    # 以追加模式初始化ExcelWriter，指定openpyxl引擎
    with pd.ExcelWriter(target, engine='openpyxl', mode='a', if_sheet_exists='replace') as writer:
        # 将DataFrame写入指定工作表，表名已存在则替换
        view.to_excel(writer, sheet_name="FCST Aug 2022", index=False)
except Exception as e:
    print(f"错误信息: {str(e)}")

关键注意事项 #

• 格式要求：必须使用.xlsx或.xlsm格式，若原文件是.xls，先转换为xlsx格式再操作。
• 文件状态：操作前关闭Excel客户端中打开的目标文件，避免文件被锁定导致写入失败。
• 模式与冲突处理：必须指定mode='a'，if_sheet_exists参数可设为'replace'（替换现有表）或'new'（自动重命名新表），规避表名重复报错。
• 上下文管理器：用with语句管理ExcelWriter，无需手动调用save()，能自动处理文件关闭，降低异常概率。

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