引子

本来以为在 Ubuntu 上安装 opencv 很简单，没有想到折腾了一下午。
想到其他同学可能会遇到类似的问题，因此把过程和坑记录下来。

概述

OpenCV 是用于计算机视觉和机器学习应用的强大库。安装最新版本，如 4.9.0，有时可能会遇到挑战，特别是在处理系统依赖和配置时。

初始设置

• 依赖安装：在开始安装之前，需要安装必要的依赖：
• 
  

sudo apt update sudo apt install -y build-essential cmake git libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev sudo apt install -y libtbb2 libtbb-dev libjpeg-dev libpng-dev libtiff-dev libdc1394-22-dev sudo apt install -y libv4l-dev v4l-utils qv4l2 v4l2ucp sudo apt install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev sudo apt install -y libxvidcore-dev libx264-dev x264 sudo apt install -y python3-dev python3-numpy

• 克隆 OpenCV 和 OpenCV Contrib 仓库：
• 
  

mkdir ~/opencv_build && cd ~/opencv_build 
git clone https://github.com/opencv/opencv.git 
git clone https://github.com/opencv/opencv_contrib.git

• 检出所需版本（4.9.0）：
• 
  

cd opencv git checkout 4.9.0 cd ../opencv_contrib git checkout 4.9.0

配置和编译

• 使用 CMake 配置： 在 opencv 文件夹中创建一个构建目录，然后使用 cmake 配置构建：
• 
  

cd ~/opencv_build/opencv mkdir build && cd build cmake -D CMAKE_BUILD_TYPE=RELEASE \ -D CMAKE_INSTALL_PREFIX=/usr/local \ -D INSTALL_C_EXAMPLES=ON \ -D INSTALL_PYTHON_EXAMPLES=ON \ -D WITH_TBB=ON \ -D WITH_V4L=ON \ -D WITH_QT=OFF \ -D WITH_OPENGL=ON \ -D OPENCV_EXTRA_MODULES_PATH=~/opencv_build/opencv_contrib/modules \ -D BUILD_EXAMPLES=ON ..

• 使用 make 构建：

make -j$(nproc) sudo make install

遇到的挑战和解决方案

1. CMake 未找到 CMakeLists.txt：
   最初，cmake 由于路径指定不正确而无法找到 CMakeLists.txt 文件。通过确保在正确的目录层次结构中运行命令解决了此问题。
2. 与 Anaconda 的 Python 冲突：
   在构建过程中遇到了使用 Anaconda 的 Python 解释器的问题，导致配置和链接问题。通过在 CMake 配置中明确指定系统 Python 路径，并临时修改 PATH 环境变量以排除 Anaconda 路径来解决。
3. 链接错误：
   由于 Anaconda 库的链接错误，例如 libgio-2.0.so.0，阻碍了构建过程。通过在构建过程中排除 Anaconda 库路径并确保 cmake 使用系统库解决。

安装后的设置

• 环境设置： 更新 LD_LIBRARY_PATH 以包括新安装的 OpenCV 库的路径：

export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

• 验证安装： 通过检查 OpenCV 的版本来验证安装是否正确：

python3 -c "import cv2; print(cv2.__version__)"

结论

本指南详细介绍了在 Ubuntu 22 上安装 OpenCV 4.9.0 的步骤，详细说明了常见的问题