使用xlwings通过Excel VBA宏调用Python脚本报错如何解决

问题1：VBA编译错误「Sub or Function not defined」 #

该报错是因为VBA环境未识别RunPython方法，按以下步骤处理：

• 确认xlwings COM加载项已启用：打开Excel→文件→选项→加载项，底部「管理」选择「COM加载项」→点击「转到」，确认xlwings加载项处于勾选状态
• 若加载项已启用仍报错，需将xlwings的VBA模块导入当前工作簿：
  1. 按Alt+F11打开VBA编辑器
  2. 右键点击当前工作簿名称→选择「导入文件」，找到Python安装目录下Lib/site-packages/xlwings/xlwings.bas文件导入即可

如果确认VBA可正常触发RunPython，但使用xw.Book.caller()时报错，需确保脚本是通过Excel宏触发，直接本地运行Python脚本时caller()没有调用源会报错，你手动指定固定文件名可正常运行是因为绕过了调用源识别逻辑，正常宏调用场景下caller()无需写死文件名，适配性更强。

问题2：AttributeError: module 'xlwings.utils' has no attribute 'prepare_sys_path' #

该报错是版本不匹配导致：prepare_sys_path方法是xlwings v0.26.0及以上版本才新增的功能，你当前使用的v0.25.0版本不包含该方法，可选择以下任意一种方案处理：

• 方案1：升级xlwings版本到最新稳定版，同时保证Python包和Excel加载项版本一致。执行命令pip install --upgrade xlwings完成Python包升级，再执行xlwings addin install重装对应版本的Excel加载项即可
• 方案2：保留v0.25.0版本的情况下，删除示例代码中调用prepare_sys_path的相关逻辑，也可在Python脚本开头手动添加工作目录到系统路径：

  import sys
  from pathlib import Path
  sys.path.append(str(Path(__file__).parent.absolute()))
  

通用注意事项 #

• 被调用的Python脚本建议和Excel工作簿放在同一目录下，避免路径找不到的问题
• xlwings的Python包版本必须和Excel加载项版本完全一致，否则会出现各类兼容问题

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