Windows环境下Python报Gooey模块缺失且pip安装Gooey失败求助

故障场景 #

• 基于Gooey开发的Python程序，在Mac端PyCharm环境可100%正常运行，切换到Windows系统执行时触发如下报错：

  from gooey import Gooey. GooeyParser
  ModuleNotFoundError: No module named 'gooey'
  

• 针对模块缺失问题，执行标准安装命令：

  pip install Gooey
  

  安装执行完成后，流程触发了新的异常报错。

注意：上述初始报错的import语句存在笔误，正确语法应为from gooey import Gooey, GooeyParser，拼写错误也会直接触发模块导入失败。

排查修复方案 #

• 校验pip与Python解释器的路径匹配关系
  • Windows环境普遍存在多Python版本共存的情况，直接执行pip install可能将Gooey安装到了其他Python版本的依赖目录下，而当前运行程序的解释器无法识别该路径
  • 可执行pip -V查看当前pip关联的解释器绝对路径，和PyCharm内配置的项目解释器路径做比对，若路径不匹配，直接使用项目解释器的绝对路径调用pip完成安装，命令格式为：<你的项目解释器绝对路径> -m pip install Gooey
• 确认Python版本与Gooey的兼容性
  • Gooey有明确的适配Python版本范围，版本过高或过低都可能触发安装失败：比如低版本Gooey不兼容Python 3.10及以上的新语法，也无法在已经停止维护的Python 3.6及更早版本上正常运行
  • 可先执行python --version确认当前环境的Python版本，匹配Gooey官方支持的版本区间后再执行安装操作
• 处理核心依赖的编译报错
  • Gooey的核心运行依赖是wxPython，Windows端如果缺少对应的C编译环境，会在安装wxPython时触发源码编译失败
  • 可先手动下载适配当前Python版本、Windows系统架构的wxPython预编译whl包，手动完成安装后再重新执行Gooey的安装命令，规避源码编译环节的报错
• 完成安装后的环境校验
  • 安装结束后，在PyCharm的项目解释器配置页，查看已安装包列表是否存在Gooey条目，确认识别正常后再重启程序运行

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