OpenCV 安装（C++）

原创于 2025-10-22 10:15:44 发布 · 1.2k 阅读

12 ·

CC 4.0 BY-SA版权

文章标签：

#opencv #c++ #人工智能

python 同时被 3 个专栏收录

125 篇文章

订阅专栏

人工智能

70 篇文章

订阅专栏

opencv

5 篇文章

订阅专栏

部署运行你感兴趣的模型镜像

安装 OpenCV 的 C++ 版本需要在开发环境中配置 OpenCV 库，包括下载源码、编译（或使用预编译库）以及设置开发环境。本教程以中文讲解，针对 Windows、Linux 和 macOS 系统，提供详细的安装步骤、验证方法和常见问题解决，力求简洁清晰，适合初学者和有经验的开发者。

一、前提条件

C++ 编译器：
- Windows：安装 Visual Studio（推荐 2019 或 2022，包含 C++ 开发组件）。
- Linux：安装 g++（通过 sudo apt-get install build-essential）。
- macOS：安装 Xcode（包含 clang）或通过 Homebrew 安装 gcc。
CMake：用于生成构建文件，下载地址：https://cmake.org/download/。
Git（可选）：用于从 GitHub 克隆 OpenCV 源码。
依赖库：OpenCV 依赖 libpng、libjpeg 等，编译时通常自动处理。

二、安装 OpenCV（C++）

以下提供两种方法：使用预编译库（简单，推荐初学者）和从源码编译（灵活，适合自定义需求）。

方法 1：使用预编译库（Windows 推荐）

1. 下载预编译库

访问 OpenCV 官网（https://opencv.org/releases/）或 GitHub（https://github.com/opencv/opencv/releases）。
下载最新版本（如 opencv-4.10.0-vc14_vc15.exe）。
解压到指定目录（如 C:\opencv）。

2. 设置环境变量

将 OpenCV 的 bin 目录添加到系统 PATH：
- 路径示例：C:\opencv\build\x64\vc15\bin（根据 Visual Studio 版本选择 vc14 或 vc15）。
- 操作：右键“此电脑” > 属性 > 高级系统设置 > 环境变量 > 编辑 Path。

3. 配置 Visual Studio 项目

创建一个新的 C++ 项目（控制台应用程序）。
在项目属性中配置：
- 包含目录：添加 C:\opencv\build\include。
- 库目录：添加 C:\opencv\build\x64\vc15\lib。
- 链接器输入：添加 opencv_world410.lib（410 对应版本 4.10.0，Release 模式）。
- 调试模式：若为 Debug 模式，使用 opencv_world410d.lib。
确保项目平台为 x64，与 OpenCV 库匹配。

方法 2：从源码编译

2.1 安装依赖

Linux (Ubuntu)：

sudo apt-get update
sudo apt-get install build-essential cmake git libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev
sudo apt-get install python3-dev python3-numpy libtbb2 libtbb-dev libjpeg-dev libpng-dev libtiff-dev libdc1394-22-dev

macOS（使用 Homebrew）：

brew install cmake git libpng jpeg libtiff ffmpeg tbb

Windows：

安装 Visual Studio（包含 C++ 开发组件）。
安装 CMake（https://cmake.org/download/）。
可选：安装 MinGW（若不使用 Visual Studio）。

2.2 下载 OpenCV 源码

git clone https://github.com/opencv/opencv.git
git clone https://github.com/opencv/opencv_contrib.git  # 可选，包含额外模块如 SIFT
cd opencv

切换到特定版本（可选）：

git checkout 4.10.0

2.3 创建构建目录

mkdir build && cd build

2.4 配置 CMake

Linux/macOS：

cmake -D CMAKE_BUILD_TYPE=Release \
      -D CMAKE_INSTALL_PREFIX=/usr/local \
      -D OPENCV_EXTRA_MODULES_PATH=../opencv_contrib/modules \
      -D WITH_TBB=ON \
      -D WITH_OPENMP=ON \
      -D WITH_FFMPEG=ON \
      ../

Windows（使用 CMake GUI 或命令行）：

打开 CMake GUI：
- 设置源码目录（opencv 目录）。
- 设置构建目录（opencv/build）。
配置选项：
- CMAKE_INSTALL_PREFIX：设置安装路径（如 C:\opencv\install）。
- OPENCV_EXTRA_MODULES_PATH：指向 opencv_contrib/modules（若使用）。
- 勾选 WITH_TBB、WITH_OPENMP、WITH_FFMPEG（可选，视需求启用）。
点击 Configure，选择编译器（如 Visual Studio 16 2019，平台 x64），然后 Generate。

2.5 编译与安装

Linux/macOS：

make -j$(nproc)  # 并行编译，加速
sudo make install

Windows：

打开 build 目录中的 OpenCV.sln（Visual Studio 项目文件）。
在 Visual Studio 中：
- 选择 Release 或 Debug 模式。
- 构建 ALL_BUILD 项目。
- 构建 INSTALL 项目，将 OpenCV 安装到 CMAKE_INSTALL_PREFIX 指定的路径。

2.6 设置环境变量

Linux：安装后库自动配置到 /usr/local/lib，可验证：
```
pkg-config --cflags --libs opencv4
```
Windows：将安装路径的 bin 目录（如 C:\opencv\install\x64\vc16\bin）添加到系统 PATH。

三、验证安装

3.1 测试代码

创建一个简单的 C++ 程序（test_opencv.cpp）：

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

int main() {
    std::cout << "OpenCV Version: " << CV_VERSION << std::endl;
    
    cv::Mat img = cv::imread("test.jpg"); // 替换为你的图像路径
    if (img.empty()) {
        std::cout << "错误：无法加载图像" << std::endl;
        return -1;
    }
    
    cv::imshow("图像", img);
    cv::waitKey(0);
    cv::destroyAllWindows();
    return 0;
}

3.2 编译与运行

Linux：

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

macOS（类似 Linux）：

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

Windows (Visual Studio)：

创建新项目，添加 test_opencv.cpp。
配置项目属性：
- 包含目录：添加 OpenCV 的 include 路径（如 C:\opencv\install\include）。
- 库目录：添加 OpenCV 的 lib 路径（如 C:\opencv\install\x64\vc16\lib）。
- 链接器输入：添加 opencv_world410.lib（Release 模式）或 opencv_world410d.lib（Debug 模式）。
编译并运行，确保 test.jpg 存在。

输出示例：

OpenCV Version: 4.10.0

如果图像窗口显示，说明安装成功。

四、常见问题及解决方法

CMake 配置失败：
- 确保依赖库齐全（Linux: libpng-dev, libjpeg-dev；macOS: 通过 Homebrew 安装）。
- 检查 CMake 版本（建议 3.10+）。
- Windows：确保选择正确的 Visual Studio 版本和平台（x64）。
链接错误（undefined reference）：
- Linux/macOS：确认 pkg-config --libs opencv4 输出正确库路径。
- Windows：检查 .lib 文件路径和名称（如 opencv_world410.lib）是否正确。
图像加载失败：
- 确保图像路径正确，文件存在。
- 检查文件格式（支持 JPG、PNG 等）。
动态库缺失：
- Linux：运行 sudo ldconfig 更新库缓存。
- Windows：确保 OpenCV 的 bin 目录（如 C:\opencv\install\x64\vc16\bin）在系统 PATH 中。
版本问题：
- 若需特定版本，克隆源码后切换：
```
git checkout 4.10.0
```