### 安装 OpenCV 和 Picamera 库 #### 准备工作 为了确保顺利安装 OpenCV 及其依赖项，在开始之前应更新并升级现有的软件包列表。这可以通过运行以下命令完成： ```bash sudo apt update && sudo apt upgrade -y ``` #### 安装基础依赖 对于 OpenCV 的编译安装，需要先安装一系列的基础开发工具和库文件。这些依赖关系包括构建工具、图像处理库和其他必要的组件。 ```bash sudo apt install build-essential cmake git pkg-config libgtk2.0-dev \ libavcodec-dev libavformat-dev libswscale-dev python3-dev python3-numpy \ libtbb2 libtbb-dev libjpeg-dev libpng-dev libtiff-dev libdc1394-22-dev \ ffmpeg libv4l-dev v4l-utils qv4l2 v4l2ucp libopenblas-dev libatlas-base-dev \ liblapacke-dev gfortran openexr libwebp-dev unzip wget curl ffmpeg \ libxvidcore-dev libx264-dev libjpeg8-dev libtiff5-dev libjasper-dev \ libilmbase-dev libgstreamer-plugins-base1.0-dev libgstreamer1.0-dev \ qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools libfaac-dev libmp3lame-dev \ libtheora-dev libopencore-amrnb-dev libopencore-amrwb-dev speexdsp-dev \ libxine2-dev libvorbis-dev libxvidcore-dev x264 v4l-utils doxygen \ python3-pip python3-setuptools python3-wheel python3-scipy cython3 \ libhdf5-dev libhdf5-serial-dev libhdf5-cpp-1.8.176 hdf5-helpers \ libprotobuf-dev protobuf-compiler libgoogle-glog-dev libgflags-dev \ libgphoto2-dev libeigen3-dev libflann-dev libvtk7-dev libspnav-dev \ libharfbuzz-dev libfribidi-dev leptonica-progs tesseract-ocr \ libtesseract-dev liblept-dev checkinstall yasm nasm swig ninja-build \ libboost-all-dev libyaml-cpp-dev[^1] ``` #### 获取 OpenCV 源码 下载指定版本的 OpenCV 和 opencv_contrib 仓库到本地计算机，并解压它们以便后续配置与编译操作。 ```bash cd ~ git clone https://github.com/opencv/opencv.git cd ~/opencv git checkout tags/4.x -b 4.x cd .. git clone https://github.com/opencv/opencv_contrib.git cd ~/opencv_contrib git checkout tags/4.x -b 4.x ``` #### 编译安装 OpenCV 创建一个新的目录用于存放编译过程中产生的临时文件，并进入该目录执行 CMake 配置以及 Make 构建过程。 ```bash mkdir -p ~/opencv/build && cd ~/opencv/build cmake -D CMAKE_BUILD_TYPE=RELEASE \ -D CMAKE_INSTALL_PREFIX=/usr/local \ -D INSTALL_C_EXAMPLES=ON \ -D INSTALL_PYTHON_EXAMPLES=ON \ -D OPENCV_EXTRA_MODULES_PATH=~/opencv_contrib/modules \ -D BUILD_EXAMPLES=ON .. make -j$(nproc) sudo make install sudo ldconfig ``` #### 安装 Python 绑定 为了让 Python 能够调用刚刚编译好的 OpenCV 功能模块，还需要额外设置一些环境变量或者通过 pip 工具直接获取预编译版的 cv2 接口。 如果遇到 `fatal error` 类似于找不到特定头文件的情况，则可能是由于某些可选功能未被正确启用或是缺少对应的第三方扩展支持所致[^2]。此时建议仔细检查 CMake 输出日志中的提示信息，确认所有必需选项均已勾选并且路径无误后再重新尝试编译流程。 针对树莓派官方最新的 64 位或 32 位操作系统而言，有时会因为 NumPy 版本不兼容而导致无法正常安装 OpenCV 。对此情况的一个解决方案就是跳过使用 pip 来管理这部分依赖关系，转而依靠系统自带的 APT 包管理系统来进行自动化部署[^3]。 #### 安装 Picamera 库 Picamera 是一个专门为 Raspberry Pi Camera Module 设计的 Python 库，允许开发者轻松访问相机硬件特性。考虑到当前使用的 Raspbian 或 Bookworm 发行版可能已经包含了此库的新版本，默认情况下只需简单地利用 pip 命令即可快速完成安装。 ```bash pip3 install picamera[array] ``` 需要注意的是，上述指令适用于 Python 3 环境；如果是其他编程语言或者是更早的操作系统版本，请参照官方文档调整相应的安装方法。