PyInstaller打包PyQt5钩子导入失败问题求助

问题核心 #

执行打包命令 pyinstaller --onefile --debug=all main.py 时失败，报错提示无法从'PyInstaller.utils.hooks.qt'导入名称'get_qt_binaries'，随后触发ImportErrorWhenRunningHook异常。移除Pandas导入后可正常生成exe，排查为PyQt5钩子与当前PyInstaller/Pandas版本不兼容导致冲突。

解决方案 #

方案1：移除不必要的PyQt5依赖（优先推荐） #

你的项目实际使用Tkinter而非PyQt5，环境中残留的PyQt5会触发PyInstaller的Qt钩子逻辑，导致不必要的冲突：

• 执行卸载命令：

  pip uninstall -y pyqt5
  

• 重新运行打包命令验证结果。

方案2：升级兼容的版本组合 #

版本不匹配是钩子错误的常见诱因，统一升级到稳定兼容的版本：

• 执行升级命令：

  pip install --upgrade pyinstaller pyqt5 pandas
  

  推荐组合：PyInstaller 5.10+ + PyQt5 5.15.x + Pandas 1.5.x及以上

方案3：自定义PyQt5钩子文件 #

若必须保留PyQt5，手动编写钩子覆盖错误的默认逻辑：

1. 在项目根目录创建hook-pyqt5.py文件，写入以下内容：

   from PyInstaller.utils.hooks import collect_all
   
   datas, binaries, hiddenimports = collect_all('PyQt5')
   

2. 打包时指定自定义钩子目录：

   pyinstaller --onefile --debug=all --additional-hooks-dir=. main.py
   

方案4：彻底重装PyInstaller #

若PyInstaller的Qt钩子文件损坏，彻底清理后重装：

1. 卸载PyInstaller：

   pip uninstall -y pyinstaller
   

2. 删除Python安装目录下的Lib\site-packages\PyInstaller文件夹（路径示例：C:\Users\你的用户名\AppData\Local\Programs\Python\PythonXX\Lib\site-packages）
3. 重新安装PyInstaller：

   pip install pyinstaller
   

原因说明 #

PyInstaller会自动为依赖库加载对应钩子文件，当环境中存在PyQt5时，Pandas的间接依赖或PyInstaller的自动检测逻辑会触发Qt钩子。若钩子文件中的get_qt_binaries方法因版本迭代被移除/重命名，就会出现导入错误。

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