PyInstaller打包因缺失sklearn模块失败，寻求排查方案

排查思路 #

• 检查PyInstaller的hook识别情况：PyInstaller靠hook自动收集模块，sklearn结构特殊，部分子模块可能无法被自动检测。查看打包日志，确认sklearn.metrics或sklearn.metrics.r2_score是否被纳入打包范围；也可以检查环境中是否存在sklearn对应的hook文件（一般在PyInstaller的hooks目录下）。
• 追踪代码的隐性依赖：即使只显式导入r2_score，sklearn.metrics内部可能会引用其他子模块，PyInstaller可能没追踪到。运行python -v ui_center.py（替换为你的主脚本），查看实际运行时加载的所有sklearn相关模块，这些都是需要打包的依赖。
• 确认虚拟环境的正确性：如果用了虚拟环境，确保打包时激活的是目标环境，且sklearn确实安装在该环境中。避免系统全局Python和虚拟环境的包混淆，导致PyInstaller找不到正确的模块位置。

解决建议 #

• 手动指定隐藏依赖：在打包命令中添加--hidden-import参数强制纳入模块，修改后的命令如下：

  pyinstaller --noconsole --onefile --hidden-import sklearn.metrics --hidden-import sklearn.metrics.r2_score ui_center.py advanced_plots.py find_centroid.py
  

• 用.spec文件配置依赖：先生成.spec文件（运行原打包命令后会自动生成），打开.spec文件找到hiddenimports列表，添加'sklearn.metrics', 'sklearn.metrics.r2_score'，然后执行pyinstaller ui_center.spec重新打包。这种方式能更精准地控制打包内容。
• 降级PyInstaller版本：部分新版本PyInstaller对sklearn的hook支持存在bug，可尝试降级到稳定版本，比如执行pip install pyinstaller==5.13.2后再重新打包。
• 切换sklearn的安装方式：如果是用conda安装的sklearn，兼容性可能不如pip安装的好，执行pip uninstall scikit-learn -y && pip install scikit-learn重新安装后再尝试打包。

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