树莓派3B+安装OpenCV遇编译Wheels错误，求解决方案及镜像

一、修复pip编译失败的问题 #

pip安装失败核心是树莓派3B+性能有限，编译OpenCV的wheel耗时久且容易失败，先补全依赖再尝试：

• 先更新系统并安装编译必需的依赖：

  sudo apt update && sudo apt upgrade -y
  sudo apt install build-essential cmake git pkg-config libgtk-3-dev \
    libavcodec-dev libavformat-dev libswscale-dev libv4l-dev \
    libxvidcore-dev libx264-dev libjpeg-dev libpng-dev libtiff-dev \
    gfortran openexr libatlas-base-dev python3-dev python3-numpy \
    libtbb2 libtbb-dev libdc1394-22-dev
  

• 升级pip和相关工具后再安装：

  python3 -m pip install --upgrade pip setuptools wheel
  python3 -m pip install opencv-python
  

  如果还是失败，试试安装对ARM架构兼容性更好的旧版本（比如4.5.5.62，这个版本的预编译wheel适配树莓派3）：

  python3 -m pip install opencv-python==4.5.5.62
  

二、用apt直接安装（最省心） #

树莓派官方源提供了预编译的OpenCV包，无需编译，直接安装：

sudo apt install python3-opencv

安装完成后直接在Python中导入import cv2即可使用，版本可能不是最新但胜在稳定，适合快速部署。

三、预装OpenCV的系统镜像 #

官方Raspberry Pi OS没有预装OpenCV，但第三方镜像有现成的：

• 一些专注于计算机视觉的第三方镜像会预装OpenCV、TensorFlow等工具，注意选择适配树莓派3B+的版本。
• 也可以自己制作：安装好系统和OpenCV后，通过raspi-config的备份功能生成自定义镜像，后续复用更方便。

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