Ubuntu20.04+VSCode配置OpenCV4.5的完整踩坑记录（C++开发必备）

原创

于 2026-02-18 05:00:56 发布 · 1k 阅读

标签

#Ubuntu #VSCode #OpenCV #C++

Ubuntu 20.04 + VSCode 配置 OpenCV 4.5 的终极避坑指南

作为一名长期从事计算机视觉开发的工程师，我深知环境配置是许多新手开发者的第一道门槛。本文将带你完整走通 Ubuntu 20.04 下使用 VSCode 配置 OpenCV 4.5 的全过程，重点解决那些官方文档不会告诉你的实际问题。不同于基础教程，这里会深入每个配置细节，解释为什么需要这样设置，以及遇到常见错误时该如何排查。

1. 环境准备与基础安装

在开始配置之前，我们需要确保系统环境已经就绪。Ubuntu 20.04 作为长期支持版本，其稳定性和兼容性都非常适合开发环境搭建。

首先更新系统软件包列表并升级现有软件：

sudo apt update && sudo apt upgrade -y

安装必要的编译工具和依赖项：

sudo apt install -y 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

这些依赖项包含了图像和视频处理所需的各种库文件。其中特别需要注意的是：

libgtk-3-dev：用于图形界面显示
libtbb-dev：Intel 线程构建模块，提升多线程性能
libdc1394-22-dev：工业相机支持

提示：如果后续编译过程中提示缺少某些依赖，可以根据错误信息单独安装对应的开发包。

2. OpenCV 4.5 源码编译与安装

直接从源码编译安装 OpenCV 可以确保我们获得最新功能，并且能够针对特定硬件进行优化。

2.1 下载 OpenCV 源码

首先创建并进入工作目录：

mkdir ~/opencv_build && cd ~/opencv_build

下载 OpenCV 和 OpenCV contrib 源码（contrib 包含额外的模块）：

git clone https://github.com/opencv/opencv.git -b 4.5.0
git clone https://github.com/opencv/opencv_contrib.git -b 4.5.0

2.2 配置编译选项

创建构建目录并进入：

cd opencv && mkdir build && cd build

使用 CMake 配置构建选项。以下是一个推荐的基础配置：

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 \

最低0.47元/天解锁文章