树莓派3B+安装opencv-python失败及导入错误求助

一、解决pip install opencv-python编译Wheel失败问题 #

树莓派3B+性能有限，直接编译OpenCV Wheel容易失败，先补全系统依赖再尝试：

• 更新系统并安装基础编译依赖：

  sudo apt-get update && sudo apt-get install -y build-essential git libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev
  

• 安装图像格式支持依赖：

  sudo apt-get install -y libjpeg-dev libpng-dev libtiff-dev libjasper-dev
  

• 若仍失败，优先使用预编译包或指定兼容版本，避免本地编译。

二、解决安装成功但import cv2提示“module not found”问题 #

核心原因是安装环境与运行环境不匹配：

• 确认Python版本对应：Raspbian默认python指向2.7，python3指向3.x，需用对应版本的pip安装：

  pip3 install opencv-python==4.5.3.56
  

• 验证安装路径：执行pip3 show opencv-python查看Location字段，再在Python3中运行以下命令确认路径是否在搜索列表：

  import sys
  print(sys.path)
  

  若路径不在，可临时添加（仅当前会话有效）：

  import sys
  sys.path.append("pip3 show里的Location路径")
  

• 检查虚拟环境：若使用了虚拟环境，需激活后再安装和运行代码。

三、解决GitHub源码安装时无法安装cmake的问题 #

• 先卸载系统旧版cmake：

  sudo apt-get remove --purge cmake
  

• 安装cmake编译依赖：

  sudo apt-get install -y libssl-dev
  

• 从源码编译安装兼容32位系统的cmake：

  # 下载cmake 3.22.1源码（适配32位系统的稳定版本）
  wget https://github.com/Kitware/CMake/releases/download/v3.22.1/cmake-3.22.1.tar.gz
  tar -zxvf cmake-3.22.1.tar.gz && cd cmake-3.22.1
  # 配置编译参数
  ./bootstrap --prefix=/usr/local
  # 编译安装（-j4用4核加速，树莓派3B+支持）
  make -j4 && sudo make install
  

• 验证安装：

  cmake --version
  

更简便的替代方案 #

直接使用Raspbian官方源的预编译包，无需编译，兼容性拉满：

sudo apt-get update && sudo apt-get install -y python3-opencv

安装完成后直接在Python3中import cv2即可使用。

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