Visual_studio中配置C++版OpenCV（超详细图像教程，附C++测试代码）

原创于 2025-06-06 17:15:00 发布 · 993 阅读

20 ·

CC 4.0 BY-SA版权

文章标签：

#c++ #opencv #开发语言

C++ OpenCv 专栏收录该内容

9 篇文章

订阅专栏

在这里插入图片描述

💪 图像算法工程师，专业从事且热爱图像处理，图像处理专栏更新如下👇：
📝《图像去噪》
📝《超分辨率重建》
📝《语义分割》
📝《风格迁移》
📝《目标检测》
📝《图像增强》
📝《模型优化》
📝《模型实战部署》
📝《图像配准融合》
📝《数据集》
📝《高效助手》
📝《C++》
📝《Qt》

在这里插入图片描述

一、OpenCV包

1.1 OpenCV包下载

从官网上下载OpenCV包的方法见下：

官网链接：OpenCV

打开官网链接后选择查看OpenCV已发布各历史版本，见下：

在这里插入图片描述

在打开的历史版本中选择自己想要下载的版本点击进去，我自己下载的是4.10.0版本，见下：

在这里插入图片描述

击进去后是OpenCV4.10.0包相关的文件，具体各个文件分别是啥，见下：

1.2 各包解析

1.2.1 opencv-4.10.0-android-sdk.zip

opencv-4.10.0-android-sdk.zip包是Android 平台的预编译 SDK，包含 OpenCV 的 Java 和 C++ 库（.aar、.so）、头文件、示例代码和 Android 构建工具。

适用场景：开发 Android 应用时直接集成 OpenCV。

1.2.2 opencv-4.10.0-docs.zip

opencv-4.10.0-docs.zip包是OpenCV 的离线文档，包含 API 参考、教程和示例代码。解压后，打开 doc/html/index.html 用浏览器查看。
搜索函数名或模块名快速查阅 API 细节，适合离线学习或调试时参考。

1.2.3 opencv-4.10.0-ios-framework.zip

opencv-4.10.0-ios-framework.zip包是iOS 平台的预编译框架（.framework），支持 Objective-C 和 Swift。

适用场景：开发 iOS 应用时快速集成 OpenCV。

1.2.4 opencv-4.10.0-windows.exe

opencv-4.10.0-windows.exe包是Windows 平台的安装程序，包含预编译的二进制文件（.dll、.lib）、头文件和示例。

本教程就是基于windows讲解，所以下载此包。

在这里插入图片描述

1.2.5 Source code (zip) 和 Source code (tar.gz)

Source code (zip) 和 Source code (tar.gz)两个包都是OpenCV 核心库的完整源代码（不含 opencv_contrib），格式为 ZIP 或压缩的 tar.gz。

适用场景：需要自行编译 OpenCV（如添加 CUDA 支持、修改源码或生成特定平台的库）。

使用OpenCV源码包用CMake手动编译的方法，在后面我会出一篇教程。

1.3 解压预编译包

下面是下载好预编译包好后解压方法，见下：

在这里插入图片描述

解压后的预编译包见下：

在这里插入图片描述

二、Visual_studio中配置OpenCV

2.1 配置包目录

学者先自己打开Visual_studio软件新建一个项目工程，打开后鼠标定位到项目工程文件名，右击鼠标选项属性，添加包目录的详细步骤见下：

在这里插入图片描述

下面是导入opencv包路径：

在这里插入图片描述

添加后的样子见下：

在这里插入图片描述

同样的方法添加opencv2路径，见下：

在这里插入图片描述

2.2 配置库目录

下面是添加库目录的详细步骤，见下：

在这里插入图片描述

2.3 配置链接器

先声明：opencv4.10.0\opencv\build\x64\vc16\lib路径中的opencv_world4100d.lib文件依赖项用于配置Debug模式，opencv_world4100.lib文件依赖项用于配置Release模式。

下面是链接器的配置的详细步骤，我自己选择的是Debug模式：

在这里插入图片描述

没有第7步骤，直接接上下面图片中的第8步骤：

在这里插入图片描述

三、测试是否配置成功

3.1 编译器选择

如果配置的是Debug模式，选项见下：

在这里插入图片描述

3.2 测试代码

测试opencv是否配置成功，测试代码见下：

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

using namespace std;
using namespace cv;

int main()
{
    //OpenCV版本号
    cout << "OpenCV_Version: " << CV_VERSION << endl;

    //读取图片
    Mat image = imread("D:/code/C++/image/OIP-C.jpg");

    imshow("picture", image);
    waitKey(0);
    return 0;
}