在树莓派上安装 OpenCV-Python 有多种方法，以下是几种常用且可靠的方式：

方法一：使用 pip 安装（推荐）

这是最简单快捷的方式，尤其适用于树莓派 4B 或树莓派 5。

1. ‌更新系统包列表‌：

   sudo apt update

2. ‌安装依赖项‌（部分可能已安装）：

   sudo apt install build-essential cmake git pkg-config
   sudo apt install libjpeg-dev libtiff5-dev libjasper-dev libpng-dev
   sudo apt install libavcodec-dev libavformat-dev libswscale-dev libv4l-dev
   sudo apt install libxvidcore-dev libx264-dev libfontconfig1-dev libcairo2-dev
   sudo apt install libgdk-pixbuf2.0-dev libpango1.0-dev libgtk2.0-dev libgtk-3-dev
   sudo apt install libatlas-base-dev gfortran python3-dev python3-numpy
   

3. ‌安装 OpenCV‌：

   pip3 install opencv-python
   

   如果需要更多功能模块（如 contrib），可以安装：

   pip3 install opencv-contrib-python
   

4. ‌测试安装是否成功‌：
   打开 Python 并输入以下命令：

   import cv2
   print(cv2.__version__)
   

如果未报错，则表示安装成功。

方法二：从源码编译安装（适用于高级用户）

如果你需要特定版本或优化性能，可以选择从源码编译安装。

1. ‌安装必要的依赖库‌：

   sudo apt update
   sudo apt install build-essential cmake git pkg-config
   sudo apt install libjpeg8-dev libtiff5-dev libjasper-dev libpng12-dev
   sudo apt install libavcodec-dev libavformat-dev libswscale-dev libv4l-dev
   sudo apt install libxvidcore-dev libx264-dev libgtk2.0-dev libgtk-3-dev
   sudo apt install libatlas-base-dev gfortran python3-dev python3-numpy
   

2. ‌下载 OpenCV 源码‌：

   git clone -b 4.1.0 --recursive https://github.com/opencv/opencv.git
   git clone -b 4.1.0 --recursive https://github.com/opencv/opencv_contrib.git
   

3. ‌配置并编译‌：

   cd opencv
   mkdir build && cd build
   cmake -D CMAKE_BUILD_TYPE=RELEASE \
         -D CMAKE_INSTALL_PREFIX=/usr/local \
         -D OPENCV_EXTRA_MODULES_PATH=../../opencv_contrib/modules \
         -D ENABLE_NEON=ON \
         -D ENABLE_VFPV3=ON \
         -D BUILD_TESTS=OFF \
         -D BUILD_PERF_TESTS=OFF \
         -D BUILD_EXAMPLES=OFF \
         -D OPENCV_GENERATE_PKGCONFIG=ON ..
   make -j4
   sudo make install
   

4. ‌测试安装‌：
   同样在 Python 中导入测试：

   import cv2
   print(cv2.__version__)
   

这种方法耗时较长，但可定制性更强‌官网。

方法三：使用虚拟环境安装（推荐用于项目隔离）

如果你希望在一个独立环境中运行 OpenCV，可以使用 Python 虚拟环境。

1. ‌创建虚拟环境‌：

   python3 -m venv myenv
   source myenv/bin/activate
   

2. ‌安装 OpenCV‌：

   pip install opencv-python
   

3. ‌测试‌：

   import cv2
   print(cv2.__version__)
   

这种方式适合开发多个项目时避免依赖冲突。

注意事项

• 树莓派系统默认可能未启用摄像头功能，需通过 sudo raspi-config 启用。
• 若遇到 numpy 版本不兼容问题，可尝试升级：

  pip3 install -U numpy
  

• 推荐使用树莓派 4B 或树莓派 5，并搭配 Raspberry Pi OS（64位版）以获得更好的兼容性和性能。

以上方法均能有效在树莓派上安装 OpenCV-Python，根据你的需求选择合适的安装方式即可。