使用xlwings实现Excel列自动适配时代码无限运行的问题

问题根源 #

代码陷入无限运行，通常是这几个原因：

• with xw.App(visible=False) 已经会自动管理Excel进程生命周期，手动调用app.quit()反而可能导致进程释放异常，后台窗口卡住
• 目标Excel文件存在特殊格式（比如大量合并单元格、超大数据集），autofit整列操作耗时过长甚至阻塞
• 文件被其他程序占用（比如手动打开着），导致wb.save()无法正常写入挂起进程

修复后的代码 #

import xlwings as xw

filename = r"C:/Users/morgan/Downloads/tmp.xlsx"

# with上下文自动管理App，无需手动quit；add_book=False避免自动新建空白工作簿
with xw.App(visible=False, add_book=False) as app:
    wb = xw.Book(filename)
    try:
        for ws in wb.sheets:
            # 仅对已使用区域执行autofit，避免无意义的整列扫描
            ws.used_range.autofit(axis="columns")
        wb.save()  # 不传filename默认保存到原路径，避免重复指定可能的路径问题
    finally:
        wb.close()

额外排查建议 #

• 临时把visible=True，运行代码观察Excel窗口是否弹出错误提示（比如文件损坏、工作表被保护）
• 先拿一个只有少量数据的测试文件运行代码，验证逻辑是否正常
• 确认目标文件没有被其他程序锁定（比如Excel客户端未关闭）

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