ubuntu下c++怎么配opencv

下面给你一套在 Ubuntu 下配置 C++ + OpenCV 的常用做法，从「最简」到「推荐」都有。

一、最省事：用 apt 安装（适合新手）

1. 更新系统

sudo apt update
sudo apt upgrade

2. 安装 OpenCV

sudo apt install libopencv-dev

这会安装：

• OpenCV 头文件
• 静态/动态库
• pkg-config 支持

3. 验证安装

pkg-config --modversion opencv4

（Ubuntu 20.04+ 一般是 opencv4）

4. 写个测试程序

test.cpp

#include <opencv2/opencv.hpp>
#include <iostream>

int main() {
    cv::Mat img = cv::imread("test.jpg");
    if (img.empty()) {
        std::cout << "Image not found" << std::endl;
        return -1;
    }
    cv::imshow("test", img);
    cv::waitKey(0);
    return 0;
}

5. 编译

g++ test.cpp -o test `pkg-config --cflags --libs opencv4`

⚠️ 如果你系统里是 opencv（不是 opencv4）：

g++ test.cpp -o test `pkg-config --cflags --libs opencv`

二、推荐方式：源码编译（功能最全）

适合需要：

• 最新 OpenCV
• CUDA / contrib 模块
• 自定义选项

1. 安装依赖

sudo apt install build-essential cmake git libgtk2.0-dev pkg-config \
libavcodec-dev libavformat-dev libswscale-dev \
libjpeg-dev libpng-dev libtiff-dev

2. 下载源码

git clone https://github.com/opencv/opencv.git
cd opencv
git checkout 4.x

（可选）

git clone https://github.com/opencv/opencv_contrib.git

3. 编译

mkdir build && cd build
cmake -D CMAKE_BUILD_TYPE=Release \
      -D CMAKE_INSTALL_PREFIX=/usr/local \
      ..
make -j$(nproc)
sudo make install

4. 配置动态库

sudo ldconfig

三、用 CMake 管理 C++ 项目（推荐）

CMakeLists.txt

cmake_minimum_required(VERSION 3.10)
project(opencv_test)

find_package(OpenCV REQUIRED)

add_executable(test test.cpp)
target_link_libraries(test ${OpenCV_LIBS})

编译：

mkdir build && cd build
cmake ..
make

四、常见问题

1. 找不到 opencv

sudo apt install pkg-config

2. fatal error: opencv2/opencv.hpp

• 没装 libopencv-dev
• 或 CMake 没 find_package(OpenCV)

3. Ubuntu 版本对应 OpenCV

如果你愿意，可以告诉我：

• Ubuntu 版本
• 是否要 CUDA
• 是否用 VSCode / CLion

我可以直接给你可复制的完整配置方案。