Sklearn KMeans导致Mac OS下PyInstaller打包的.app崩溃求助

问题定位 #

Mac下未打包时程序正常运行，仅在导入KMeans后打包的.app崩溃，说明PyInstaller打包过程中未正确处理sklearn.cluster.KMeans的依赖项，导致运行时缺失必要组件。

可行解决方案 #

1. 强制收集sklearn全部依赖文件 #

使用PyInstaller的--collect-all参数，强制打包sklearn的所有相关文件，避免遗漏：

pyinstaller --collect-all sklearn --windowed your_app.py

--windowed用于GUI应用打包，避免终端窗口弹出。

2. 手动编辑spec文件补充隐藏导入 #

先生成spec文件：

pyi-makespec your_app.py

打开生成的your_app.spec，在hiddenimports列表中添加KMeans依赖的底层模块：

hiddenimports=[
    'sklearn.cluster._kmeans',
    'sklearn.utils._cython_blas',
    'sklearn.neighbors._typedefs',
    'sklearn.neighbors._quad_tree',
    'sklearn.tree._utils'
],

然后用spec文件重新打包：

pyinstaller your_app.spec

3. 手动添加sklearn数据文件 #

部分sklearn组件依赖内置数据文件，需手动添加到打包资源中。找到你的Python环境中sklearn的安装路径（示例路径：/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/site-packages/sklearn），在spec文件的datas中添加：

datas=[
    ('/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/site-packages/sklearn/datasets/data', 'sklearn/datasets/data'),
    ('/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/site-packages/sklearn/cluster/_kmeans.cpython-37m-darwin.so', 'sklearn/cluster')
],

替换为你实际的sklearn安装路径后，重新打包。

4. 降级PyInstaller版本 #

最新版PyInstaller 5.6.2可能与Python3.7、sklearn1.0.2存在兼容性问题，尝试降级到稳定版本：

pip install pyinstaller==4.10

5. 检查动态链接库依赖 #

使用otool工具检查打包后应用的库依赖情况：

otool -L dist/your_app.app/Contents/MacOS/your_app

若发现缺失的系统库，手动将对应库复制到dist/your_app.app/Contents/Frameworks目录下，或用install_name_tool调整库路径。

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