使用PyInstaller打包含OpenCV模块的Python应用时体积过大问题求助

我之前也踩过这个一模一样的坑！PyInstaller默认会把整个依赖库的所有模块一股脑打包进去，哪怕你只用到OpenCV的几个函数，这就直接导致打包后的文件夹体积飙到100MB+。下面是几个亲测有效的解决办法：

1. 手动排除不需要的OpenCV模块 #

PyInstaller提供了--exclude-module参数，可以直接在打包命令里指定要排除的冗余模块。比如你提到的aruco、dnn、hdf这些没用的模块，就可以这样写：

pyinstaller --exclude-module cv2.aruco --exclude-module cv2.dnn --exclude-module cv2.hdf your_script.py

如果还有其他用不上的模块，都可以用同样的方式追加进去。

2. 修改.spec文件做精细化控制 #

如果要排除的模块比较多，或者需要更灵活的配置，建议先生成.spec文件：

pyinstaller --name your_app your_script.py

然后打开生成的your_app.spec文件，找到Analysis部分的excludes列表，把不需要的OpenCV模块逐一加进去：

a = Analysis(
    ['your_script.py'],
    # 其他默认配置...
    excludes=['cv2.aruco', 'cv2.dnn', 'cv2.hdf', 'cv2.face', 'cv2.bgsegm'],
    # 其他默认配置...
)

之后用这个配置好的spec文件打包：

pyinstaller your_app.spec

3. 改用OpenCV的无头版本（Headless） #

如果你的应用不需要GUI相关功能（比如不需要调用cv2.imshow显示图像窗口），可以换成opencv-python-headless版本——这个版本砍掉了很多GUI相关的依赖，本身体积就小很多，打包后自然更紧凑。先卸载原来的版本，再安装无头版：

pip uninstall opencv-python
pip install opencv-python-headless

一些实用注意事项 #

• 排除模块前一定要测试应用功能，确保不会因为删掉某个模块导致运行报错。可以用pyinstaller --debug=imports your_script.py查看哪些模块实际被导入了，这样能更精准地排除冗余。
• 如果用无头版本，要确认你的应用确实不需要任何GUI相关的OpenCV函数，否则会直接报错。
• 打包完成后，可以用7-Zip这类压缩工具对生成的文件夹做进一步压缩，还能再省不少空间。

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