Python使用xlwings保存新建工作簿报traceback错误如何解决

问题现象 #

使用xlwings编写代码创建新Excel工作簿，计划后续向工作簿填充数据时，调用.save()方法无法正常执行，复现代码如下：

import xlwings as xw

app = xw.App(visible=False)
wb = xw.Book()
wb.save(r'D:\XX\report.xlsx')
wb.close()
app.quit()

运行后抛出如下traceback错误：

Traceback (most recent call last):
  File "MyPython.py", line 5, in <module>
    wb.save(r'D:\XX\report.xlsx')
  File "C:\Python38\lib\site-packages\xlwings\main.py", line 1065, in save
    self.impl.save(path, password=password)
  File "C:\Python38\lib\site-packages\xlwings\_xlwindows.py", line 829, in save
    self.xl.SaveAs(
  File "C:\Python38\lib\site-packages\xlwings\_xlwindows.py", line 95, in __call__
    v = self.__method(*args, **kwargs)
  File "C:\Users\XX\AppData\Local\Temp\gen_py\3.8\00020813-0000-0000-C000-000000000046x0x1x9.py", line 46571, in SaveAs
    return self._oleobj_.InvokeTypes(3174, LCID, 1, (24, 0), ((12, 17), (12, 17), (12, 17), (12, 17), (12, 17), (12, 17), (3, 49), (12, 17), (12, 17), (12, 17), (12, 17), (12, 17), (12, 17)),Filename
pywintypes.com_error: (-2147352573, 'Member not found.', None, None)

当前运行环境：Python 3.8.0，xlwings 0.27.7。

故障原因 #

• 核心诱因是pywin32自动生成的Excel COM类型库缓存损坏。从报错栈可以看到调用逻辑走到了系统临时目录下的gen_py缓存文件夹，缓存文件和当前系统安装的Office/WPS接口版本不匹配时，就会抛出成员找不到的COM错误。
• 原有代码写法存在缺陷：xw.Book()默认优先连接系统中已经打开的Excel进程，而非手动启动的隐藏App实例，跨进程调用接口时容易出现权限、版本不匹配问题。
• 小概率触发点：保存路径的父目录（示例中的D:\XX）不存在，xlwings不会自动创建多级目录，会直接触发接口调用异常。

解决步骤 #

1. 清理损坏的COM缓存
   直接删除路径C:\Users\当前系统用户名\AppData\Local\Temp\gen_py下的所有文件和文件夹。该目录存储win32com自动生成的类型库缓存，删除后下次调用xlwings会自动重新生成匹配当前环境的缓存文件，不会影响其他程序正常运行。
2. 修正代码逻辑
   调整工作簿创建方式，确保工作簿绑定到自行启动的独立App进程，启动App时关闭默认创建空白工作簿的配置，避免冗余进程占用，同时增加路径校验逻辑：

import xlwings as xw
import os

save_path = r'D:\XX\report.xlsx'
# 提前创建不存在的父目录
os.makedirs(os.path.dirname(save_path), exist_ok=True)

app = xw.App(visible=False, add_book=False)
wb = app.books.add()  # 绑定到当前自建App实例新建工作簿
wb.save(save_path)
wb.close()
app.quit()

3. 兼容问题处理
   如果系统默认用WPS打开xlsx文件，xlwings 0.27.7版本对WPS的COM接口兼容存在已知bug，要么升级xlwings到最新稳定版，要么修复Office的COM注册，将Excel设为xlsx格式的默认打开程序即可。

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