pandas使用ExcelWriter无法覆盖工作表反而新建带后缀工作表如何解决？

1. 确认pandas版本符合要求 #

if_sheet_exists是pandas 1.4.0版本才新增的配置项，低于该版本时参数不会生效，系统会自动为重名工作表添加数字后缀。

• 查看当前pandas版本命令：pip show pandas
• 升级到符合要求的版本命令：pip install pandas>=1.4.0

2. 避免目标文件被占用 #

如果目标Excel文件正被WPS、Office等办公软件打开，openpyxl无法修改原有工作表，会触发自动重命名逻辑。写入前请关闭所有打开该文件的程序。

3. 调整写入代码写法 #

推荐使用上下文管理器管理写入流程，自动处理资源释放，避免手动调用save导致的异常：

import pandas as pd

with pd.ExcelWriter(
    filepath,
    engine="openpyxl",
    mode="a",
    if_sheet_exists="replace"
) as writer:
    df.to_excel(writer, sheet_name="MySheetName", index=False)

如果仍存在重名后缀问题，可以在写入前主动删除原有同名工作表：

from openpyxl import load_workbook

# 先删除目标工作表
wb = load_workbook(filepath)
if "MySheetName" in wb.sheetnames:
    del wb["MySheetName"]
wb.save(filepath)

# 再执行写入逻辑
with pd.ExcelWriter(
    filepath,
    engine="openpyxl",
    mode="a"
) as writer:
    df.to_excel(writer, sheet_name="MySheetName", index=False)

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