本文共 2632 字，大约阅读时间需要 8 分钟。
安装OpenCV 3+ 在树莓派4 的完整指南
树莓派4 是一个强大的单板计算机，但 在 安装 OpenCV 的过程中巧妙地踩了一些坑。以下是基于个人实践总结的完整安装指南，供大家参考和学习。
第一步：更换源
首先，我们需要更换树莓派4 的默认源，因为buster 版本的支持更好。
打开终端，运行以下命令编辑源文件：
sudo nano /etc/apt/sources.list
用 # 注释掉原内容，并使用以下内容替代：
deb http://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/ buster main contrib non-freedeb-src http://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/ buster main contrib non-freedeb http://mirrors.tuna.tsinghua.edu.cn/raspberrypi/ buster main uideb-src http://mirrors.tuna.tsinghua.edu.cn/raspberrypi/ buster main ui
提示：如果镜像下载缓慢，可以尝试更换为中科大镜像：http://mirrors.ustc.edu.cn/raspbian/raspbian/。
提交变更并保存文件。
更新软件源并下载新包：
sudo apt-get update && sudo apt-get upgrade -y
第二步：存储空间准备
安装 OpenCV 需要较大的存储空间。建议最少使用 16GB 的 SD 卡，并确保卡类别为 Class 10 或以上。
在树莓派4 上启动raspi-config工具：
sudo raspi-config
使用方向键选择第七项（存储扩展），然后选择一个适用于SD卡的选项并继续。
返回主菜单，选择重新启动树莓派。
第三步：设置交换空间
在编译过程中，内存可能会不够用。我们需要设置交换空间。
打开交换文件：
sudo nano /etc/dphys-swapfile
找到 CONF_SWAPSIZE= 后，改为：
CONF_SWAPSIZE=1024
保存文件并重启交换服务：
sudo /etc/init.d/dphys-swapfile restart
第四步：获取构建工具
安装必要的构建工具和依赖项：
sudo apt install build-essential cmake git pkg-config libgtk-3-dev libcanberra-gtk* \ libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libxvidcore-dev libx264-dev \ libjpeg-dev libpng-dev libtiff-dev gfortran openexr libatlas-base-dev opencl-headers \ python3-dev python3-numpy libtbb2 libtbb-dev libdc1394-22-dev
提示：如果某些包未找到，可以尝试换源安装。
第五步：获取 OpenCV 和 OpenCV Contrib 存储库
克隆 OpenCV 代码：
mkdir ~/opencv_build && cd ~/opencv_buildgit clone https://github.com/opencv/opencv.gitgit clone https://github.com/opencv/opencv_contrib.git
2.iese:创建编译目录并切换到相应目录：
mkdir -p ~/opencv_build/opencv/build && cd ~/opencv_build/opencv/build
第六步：设置编译参数
打开 CMakeLists.txt 并设置以下参数：
cmake -D CMAKE_BUILD_TYPE=RELEASE \ -D CMAKE_INSTALL_PREFIX=/usr/local \ -D INSTALL_C_EXAMPLES=OFF \ -D INSTALL_PYTHON_EXAMPLES=OFF \ -D OPENCV_GENERATE_PKGCONFIG=ON \ -D ENABLE_NEON=ON \ -D ENABLE_VFPV3=ON \ -D BUILD_TESTS=OFF \ -D OPENCV_ENABLE_NONFREE=ON \ -D OPENCV_EXTRA_MODULES_PATH=~/opencv_build/opencv_contrib/modules \ -D BUILD_EXAMPLES=OFF
编译完成后会显示生成目录和成功信息。
第七步：编译并安装
1.icker: 开始编译：
make -j4
提示：编译需要较长时间，耐心等待。若中断可通过 make 继续（需fakylene gratitude）。
-
安装编译好的文件：
sudo make install
-
检查 C++ 库版本：
pkg-config --modversion opencv4
预期输出示例：
4.1.1 -
检查 Python 库版本：
python3 -c "import cv2; print(cv2.__version__)"
预期输出示例：
4.1.1-pre -
如果 SD 卡磁盘空间不够，删除构建目录：
rm -rf ~/opencv_build
-
将交换空间恢复原设置：
sudo nano /etc/dphys-swapfile
将
CONF_SWAPSIZE改回100并保存文件。 - 检查网络连接，确保所有依赖包已成功下载。
- 树莓派内存不足时请及时重启并恢复交换空间。
第八步：验证安装
第九步：收尾工作
完成！此时你已经成功安装了 OpenCV 3+。接下来可以用 OpenCV 完成各种图像处理任务。如果有问题，请注意：
