xlwings打开已打开文件时挂起，如何关闭该文件以正常操作？

阿华AIGC实验室

2026-5-25

解决xlwings打开已打开Excel文件时的挂起/报错问题

遇到这种情况其实不用慌，核心思路是优先连接已打开的文件实例，而不是强行重新打开；如果确实需要关闭已打开的文件，也可以通过xlwings的工作簿集合来操作。下面分步骤给你解决方案：

1. 连接已打开的工作簿（推荐优先使用）

xlwings提供了xw.books集合，里面包含了当前所有已打开的Excel工作簿。我们可以遍历这个集合，找到目标文件并直接连接，避免重复打开导致的报错或挂起：

import xlwings as xw

folderpath = "你的文件夹路径/"  # 替换成实际路径
file_path = folderpath + 'Metrics - auto.xlsx'

# 遍历已打开的工作簿，匹配目标文件
target_wb = None
for book in xw.books:
    # 用fullname匹配完整路径，避免重名文件混淆
    if book.fullname == file_path:
        target_wb = book
        break

# 如果没找到已打开的，再尝试新建打开
if not target_wb:
    try:
        target_wb = xw.Book(file_path)
        print("成功打开新的工作簿实例")
    except Exception as e:
        print(f"打开文件失败: {str(e)}")

这样就能无缝衔接已打开的文件，不需要关闭它就能直接操作。

2. 关闭指定的已打开工作簿

如果你确实需要关闭已打开的目标文件，可以同样通过xw.books集合定位后调用close()方法：

import xlwings as xw

folderpath = "你的文件夹路径/"
file_path = folderpath + 'Metrics - auto.xlsx'

# 查找并关闭目标文件
for book in xw.books:
    if book.fullname == file_path:
        book.close()
        print(f"已成功关闭文件: {file_path}")
        break
else:
    print("该文件未在Excel中打开")

注意：如果是用户手动打开的文件，关闭前最好做个提示，避免丢失用户未保存的修改。

3. 结合异常处理的完整示例

把上面的逻辑整合起来，写一个健壮的函数，既能处理已打开的情况，也能处理打开失败的场景：

import xlwings as xw

def get_workbook(file_path):
    # 先尝试连接已打开的工作簿
    for book in xw.books:
        if book.fullname == file_path:
            print(f"已连接到已打开的工作簿: {file_path}")
            return book
    
    # 尝试打开新实例，处理可能的错误
    try:
        wb = xw.Book(file_path)
        print(f"成功打开新工作簿: {file_path}")
        return wb
    except Exception as e:
        print(f"打开文件出错: {str(e)}")
        # 尝试关闭可能残留的实例后重试
        for book in xw.books:
            if book.fullname == file_path:
                book.close()
                print("已关闭残留的工作簿实例，正在重试打开...")
                return xw.Book(file_path)
        return None

# 使用示例
folderpath = "你的文件夹路径/"
file_path = folderpath + 'Metrics - auto.xlsx'
wb = get_workbook(file_path)

# 后续操作示例
if wb:
    sheet = wb.sheets["Sheet1"]
    print(f"当前操作工作表: {sheet.name}")
    # 完成操作后可以关闭（可选）
    # wb.close()