Pandas ExcelWriter未正常关闭致Excel编辑时共享冲突问题咨询

问题根源 #

Excel提示共享冲突，本质是Python进程未完全释放Excel文件的读写锁——即使代码执行完毕，Spyder的IPython内核会缓存变量对象，导致openpyxl底层的文件句柄/工作簿引用未被系统回收。

具体修复方案 #

1. 读取文件时显式关闭工作簿 #

pd.read_excel默认不会主动关闭openpyxl的工作簿对象，需手动加载并关闭：

import pandas as pd
import os
from openpyxl import load_workbook

path_to_excel = os.path.realpath(r"Something\Something\myfile.xlsx")

# 显式加载工作簿，读取后立即关闭
wb = load_workbook(path_to_excel)
df_excel = pd.read_excel(wb, sheet_name='Sheet 1', index_col=2)
wb.close()  # 关键：释放工作簿占用的文件锁

2. 规范使用ExcelWriter的上下文管理器 #

保留with语句的写法即可（自动处理资源释放），删除手动close()的冗余代码：

# 仅保留上下文管理器写法，确保自动释放文件资源
with pd.ExcelWriter(path=path_to_excel, mode='a', if_sheet_exists="replace", engine="openpyxl") as writer:
    df_new.to_excel(excel_writer=writer, sheet_name="Sheet 2", float_format="%.2f", index_label="Cool index name")

3. 强制释放变量引用与垃圾回收 #

操作完成后，手动删除相关对象并触发垃圾回收，彻底清除内核缓存的引用：

import gc

# 删除所有涉及Excel操作的对象
del df_excel, writer, wb
gc.collect()  # 强制回收未释放的资源

4. Spyder环境额外优化 #

Spyder的变量浏览器会保留对象引用，可通过以下方式规避：

• 运行代码前，点击工具栏的清除变量按钮（垃圾桶图标）
• 在代码末尾添加IPython魔法命令：%reset -f（强制清除所有变量）

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