OpenCV在Linux系统下的安装与配置指南

OpenCV在Linux系统下的安装与配置指南

opencv 项目地址: https://gitcode.com/gh_mirrors/op/opencv

前言

OpenCV作为计算机视觉领域最流行的开源库之一，在Linux平台上的安装是开发者需要掌握的基本技能。本文将全面介绍在Linux系统中安装OpenCV的详细步骤，包括快速安装方法和详细配置过程，帮助开发者根据实际需求选择合适的安装方式。

快速安装指南

基础模块安装

对于希望快速体验OpenCV核心功能的开发者，可以使用以下简洁的安装命令：

sudo apt-get update
sudo apt-get install -y build-essential cmake git libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev
mkdir -p ~/opencv_build && cd ~/opencv_build
git clone https://github.com/opencv/opencv.git
cd opencv
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local ..
make -j$(nproc)
sudo make install

这段脚本会自动安装必要的依赖项，下载最新OpenCV源代码，并进行编译安装。

包含扩展模块的安装

如果需要使用OpenCV的额外功能模块(opencv_contrib)，可以使用以下命令：

sudo apt-get update
sudo apt-get install -y build-essential cmake git libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev
mkdir -p ~/opencv_build && cd ~/opencv_build
git clone https://github.com/opencv/opencv.git
git clone https://github.com/opencv/opencv_contrib.git
cd opencv
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local -DOPENCV_EXTRA_MODULES_PATH=../../opencv_contrib/modules ..
make -j$(nproc)
sudo make install

详细安装过程

安装编译工具链

在开始编译OpenCV之前，需要确保系统已安装必要的开发工具：

1. 编译器选择：

   • GCC/G++编译器（推荐）：

     sudo apt-get install -y g++ gcc
     

   • 或者Clang/LLVM编译器：

     sudo apt-get install -y clang llvm
     

2. 构建工具：

   • CMake（必需）：

     sudo apt-get install -y cmake
     

   • Make或Ninja构建系统：

     # Make版本
     sudo apt-get install -y make
     # 或者Ninja版本（构建速度更快）
     sudo apt-get install -y ninja-build
     

3. 源代码获取工具：

   sudo apt-get install -y wget unzip
   # 或者使用Git
   sudo apt-get install -y git
   

获取源代码

OpenCV源代码可以通过两种方式获取：

1. 下载压缩包（适合快速安装）：

   wget -O opencv.zip https://github.com/opencv/opencv/archive/master.zip
   unzip opencv.zip
   

2. Git克隆（适合需要版本控制的开发者）：

   git clone https://github.com/opencv/opencv.git
   cd opencv
   git checkout master
   

配置与编译

1. 准备构建目录：

   mkdir -p build && cd build
   

2. CMake配置：

   • 使用Make构建系统：

     cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local ..
     

   • 使用Ninja构建系统：

     cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
     

3. 编译过程：

   • 使用Make（多线程编译）：

     make -j$(nproc)
     

   • 使用Ninja：

     ninja
     

验证构建结果

编译完成后，可以在以下目录检查生成的文件：

• build/lib：包含生成的库文件
• build/bin：包含可执行文件（测试程序、示例程序等）

使用以下命令检查：

ls -l build/lib
ls -l build/bin

安装到系统

注意：系统级安装可能会与系统包管理器产生冲突，建议谨慎操作。

默认安装到/usr/local目录：

sudo make install
# 或者使用Ninja
sudo ninja install

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

pkg-config --modversion opencv4

高级配置选项

OpenCV提供了丰富的CMake配置选项，可以根据需求进行定制：

1. 指定安装路径：

   cmake -DCMAKE_INSTALL_PREFIX=$HOME/.local ..
   

2. 启用/禁用特定模块：

   cmake -DBUILD_opencv_python3=ON -DBUILD_TESTS=OFF ..
   

3. 优化编译选项：

   cmake -DCMAKE_BUILD_TYPE=Release -DENABLE_AVX2=ON ..
   

常见问题解决

1. 依赖问题：如果配置过程中提示缺少依赖，可以根据错误信息安装相应的开发包。

2. 编译失败：尝试清理构建目录重新编译：

   cd build
   rm -rf *
   cmake ..
   make
   

3. 版本冲突：如果系统中已存在其他版本的OpenCV，建议使用自定义安装路径或在虚拟环境中安装。

结语

本文详细介绍了在Linux系统上安装OpenCV的完整流程，从快速安装到自定义配置，涵盖了开发者可能遇到的各种场景。正确安装和配置OpenCV是开发计算机视觉应用的基础，希望本文能帮助开发者顺利完成环境搭建。

opencv 项目地址: https://gitcode.com/gh_mirrors/op/opencv