树莓派OpenCV相关问题：卸载、版本选择及cv2导入报错
2026-7-31
卸载已安装的OpenCV包
- 若使用pip安装，执行命令：
pip uninstall opencv-python opencv-python-contrib - 若使用pip3（树莓派默认Python3常用），执行命令：
pip3 uninstall opencv-python opencv-python-contrib - 验证卸载结果：运行
pip list | grep opencv或pip3 list | grep opencv，无输出则表示卸载完成
树莓派人脸识别推荐保留的版本
- 应保留opencv-python-contrib，它包含人脸识别必需的扩展模块（如
cv2.face下的人脸识别、特征提取工具），基础版opencv-python没有这些功能模块。 - 版本优先选择4.5.x系列（例如4.5.5.62），该系列在树莓派ARM架构上兼容性和稳定性都较好，避免使用过于激进的新版本（可能存在ARM适配bug）。
Import cv2失败的常见原因及解决办法
- 运行环境不匹配：你执行Python脚本的环境和安装OpenCV的环境不一致，比如用
pip3安装但用python（对应Python2）运行，或者未激活虚拟环境。解决：用对应版本的Python运行脚本，比如python3 your_script.py；若使用虚拟环境，先激活再执行。 - 安装/卸载不彻底：卸载残留或安装过程出错导致模块缺失。解决：彻底卸载后重新安装指定版本的
opencv-python-contrib。 - 系统依赖缺失：OpenCV运行需要部分系统库支持。解决：在树莓派终端执行
sudo apt-get update && sudo apt-get install libatlas-base-dev libjasper-dev libqtgui4 libqt4-test补充依赖。 - 版本不兼容：OpenCV版本与Python版本不匹配。解决：安装对应Python版本兼容的OpenCV-contrib版本，例如
pip3 install opencv-python-contrib==4.5.5.62指定版本。
内容的提问来源于stack exchange，提问作者Anika A
相关产品推荐
相关产品推荐
