Ubuntu 20.04 上 OpenCV 的详细安装教程

一、安装前的准备工作

1. 更新系统软件包：
   在开始安装OpenCV之前，建议先更新Ubuntu系统的软件包列表，以确保安装的是最新版本的依赖项。bash复制代码sudo apt update sudo apt upgrade

二、安装依赖库

OpenCV依赖于多个库，包括数学库、图像库等。以下是一些常用的依赖项：

bash复制代码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 libopenexr-dev \  libgstreamer-plugins-base1.0-dev libgstreamer1.0-dev

这些依赖项涵盖了OpenCV可能需要的各种功能，如视频处理、图像编解码等。

三、安装OpenCV

OpenCV的安装有两种方式：使用包管理器安装预编译版本或从源码安装。这里主要介绍从源码安装的方法，因为它提供了更多的灵活性和可定制性。

1. 下载OpenCV源码

访问OpenCV的官方网站（OpenCV Releases）下载源码。通常，建议选择最新的稳定版本。使用wget命令或直接在浏览器中下载后通过文件传输工具上传到Ubuntu系统。

bash复制代码# 示例，具体版本号请根据实际情况选择  wget https://opencv.org/releases/opencv-4.5.5.zip  unzip opencv-4.5.5.zip  cd opencv-4.5.5

2. 创建构建目录并配置CMake

在OpenCV源码目录下创建一个构建目录，并在此目录中运行CMake来配置OpenCV的构建选项。

bash复制代码mkdir build  cd build  cmake -D CMAKE_BUILD_TYPE=RELEASE \        -D CMAKE_INSTALL_PREFIX=/usr/local \        -D OPENCV_EXTRA_MODULES_PATH=~/opencv_contrib-4.5.5/modules \        -D BUILD_EXAMPLES=ON ..

注意：

• -D CMAKE_BUILD_TYPE=RELEASE 指定构建类型为发布版，以优化性能。
• -D CMAKE_INSTALL_PREFIX=/usr/local 指定安装目录。
• -D OPENCV_EXTRA_MODULES_PATH（可选）指定额外模块（如opencv_contrib）的路径。

3. 编译和安装OpenCV

编译OpenCV可能需要一些时间，具体取决于您的系统性能。

bash复制代码make -j$(nproc)  # 使用所有可用的处理器核心来加速编译过程  sudo make install

4. 配置环境变量

为了让系统能够找到OpenCV的库和头文件，需要更新一些环境变量。

bash复制代码echo "/usr/local/lib" | sudo tee -a /etc/ld.so.conf.d/opencv.conf  sudo ldconfig    echo "export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH" | sudo tee -a /etc/bash.bashrc  source /etc/bash.bashrc

四、验证安装

安装完成后，可以通过以下命令验证OpenCV是否成功安装：

bash复制代码pkg-config --modversion opencv4

如果命令输出了OpenCV的版本号，则说明安装成功。

五、常见问题的排查和解决方法

1. 依赖项安装失败：
   • 确保网络连接正常，尝试多次执行安装命令。
   • 如果某些依赖项在Ubuntu的官方源中找不到，可以尝试添加第三方源或使用其他包管理器。
2. CMake配置错误：
   • 仔细检查CMake命令中的路径是否正确，特别是OPENCV_EXTRA_MODULES_PATH（如果使用了opencv_contrib）。
   • 查看CMake的输出信息，找出具体的错误原因并修复。
3. 编译过程中出错：
   • 根据编译错误的具体信息，查找相关的解决方案。
   • 尝试清理构建目录后重新编译：make clean 然后重新运行make命令。
4. 找不到OpenCV库：
   • 确保环境变量LD_LIBRARY_PATH和PKG_CONFIG_PATH已正确设置，并包含OpenCV的安装路径。
   • 重启终端或执行source /etc/bash.bashrc以更新环境变量。

通过以上步骤，您应该在Ubuntu 20.04系统上成功安装了OpenCV，并为其配置了必要的环境变量。现在，您可以开始使用OpenCV进行图像处理和计算机视觉相关的开发了。