Python转exe后出现OpenCV配置文件缺失错误，求解决方案

问题根源 #

打包工具（比如PyInstaller）默认不会自动收集OpenCV的config.py配置文件，而EXE运行时OpenCV的加载器依赖这个文件验证安装配置，因此出现缺失报错。

可行解决方案 #

1. 打包时手动指定包含config.py #

先找到Python环境中OpenCV的安装路径，比如虚拟环境下路径类似venv/Lib/site-packages/cv2（Windows）或venv/lib/pythonX.X/site-packages/cv2（Linux/macOS），该目录下存在config.py。

使用PyInstaller打包时，通过--add-data参数将文件纳入打包范围：

# Windows系统用分号分隔路径
pyinstaller --add-data "C:/path/to/your/env/Lib/site-packages/cv2/config.py;cv2" your_script.py

# Linux/macOS用冒号分隔路径
pyinstaller --add-data "/path/to/your/env/lib/pythonX.X/site-packages/cv2/config.py:cv2" your_script.py

2. 修改.spec文件（已生成.spec时用） #

如果已经生成了打包配置文件.spec，打开它并在datas列表中添加对应条目：

datas=[('/path/to/cv2/config.py', 'cv2')],

保存后重新执行打包：

pyinstaller your_script.spec

3. 降级OpenCV版本 #

部分新版本的opencv-python在打包兼容性上存在问题，可尝试降级到稳定版本：

pip install opencv-python==4.5.5.62

重新安装后再执行打包操作。

4. 强制导入隐藏模块 #

通过--hidden-import参数让PyInstaller强制包含OpenCV的配置模块：

pyinstaller --hidden-import cv2.config your_script.py

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