Python PyQt5项目打包exe后遇ModuleNotFoundError问题求助

• 确认打包环境的依赖完整性
  确保使用pyinstaller等打包工具时，当前运行环境已经正确安装PyQt5。如果用了虚拟环境，必须激活后再执行打包命令，否则工具会找不到依赖。

• 显式引入PyQt5模块
  打包时通过--hidden-import参数强制让打包工具包含PyQt5相关组件，示例命令：

  pyinstaller --hidden-import PyQt5 --hidden-import PyQt5.QtWidgets --hidden-import PyQt5.QtCore --hidden-import PyQt5.QtGui your_main_script.py
  

  也可以修改生成的.spec文件，在hiddenimports列表中添加这些模块，再执行pyinstaller your_script.spec重新打包：

  hiddenimports=['PyQt5', 'PyQt5.QtWidgets', 'PyQt5.QtCore', 'PyQt5.QtGui']
  

• 指定PyQt5的安装路径
  先通过pip show PyQt5查看PyQt5的安装目录，打包时用--paths参数指向该目录，示例：

  pyinstaller --paths "你的PyQt5安装路径" your_main_script.py
  

• 用干净虚拟环境重新打包
  新建虚拟环境，避免全局环境的依赖干扰，步骤如下：

  # 创建虚拟环境
  python -m venv pyqt_env
  # Windows激活环境
  pyqt_env\Scripts\activate
  # Linux/macOS激活环境
  source pyqt_env/bin/activate
  # 安装依赖
  pip install pyqt5 pyinstaller
  # 打包
  pyinstaller your_main_script.py
  

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