OpenCV作为功能强大的开源计算机视觉库，支持多种编程语言调用，其中C++版本因为执行效率高，被广泛应用于实时图像处理、工业检测、智能安防等场景。要在C++项目中使用OpenCV，首先需要完成环境配置，再学习基础的使用方法。
OpenCV下载与安装
首先前往OpenCV官方发布页面下载Windows版本的编译包，本文以OpenCV 4.8.0版本为例，下载后得到exe格式的自解压文件，双击运行选择解压路径，比如解压到D:opencv目录下，解压完成后可以看到build和sources两个文件夹，其中build文件夹包含编译好的库文件和头文件。
配置系统环境变量
需要将OpenCV的动态链接库路径添加到系统环境变量中，具体操作步骤如下：
- 右键点击此电脑，选择属性，进入高级系统设置
- 点击环境变量，在系统变量中找到Path变量，点击编辑
- 添加OpenCV的bin目录路径，比如D:opencvbuildx64vc16bin，注意根据你的Visual Studio版本选择对应的vc文件夹，vc16对应VS2019及以上版本
- 保存所有设置，重启电脑让环境变量生效
Visual Studio项目配置
打开Visual Studio创建新的C++空项目，然后配置项目的包含目录、库目录和附加依赖项：
配置包含目录
右键点击项目，选择属性，进入VC++目录，在包含目录中添加OpenCV的头文件路径：
D:opencvbuildinclude D:opencvbuildincludeopencv2
配置库目录
在库目录中添加OpenCV的库文件路径，同样根据VS版本选择对应目录：
D:opencvbuildx64vc16lib
配置附加依赖项
进入链接器-输入，在附加依赖项中添加OpenCV的lib文件名，debug版本和release版本需要区分：
debug版本添加：
opencv_world480d.lib
release版本添加：
opencv_world480.lib
注意文件名中的480对应OpenCV版本号，如果你使用的是其他版本，需要修改为对应的数字。
入门示例：读取并显示图片
完成环境配置后，可以编写简单的代码测试OpenCV是否正常工作，下面的代码实现读取本地图片并显示到窗口的功能：
#include <opencv2/opencv.hpp>
#include <iostream>
using namespace cv;
using namespace std;
int main() {
// 读取本地图片，替换为你的图片路径
Mat img = imread("D:/test.jpg");
// 判断图片是否读取成功
if (img.empty()) {
cout << "无法读取图片，请检查路径是否正确" << endl;
return -1;
}
// 创建显示窗口
namedWindow("测试窗口", WINDOW_NORMAL);
// 在窗口中显示图片
imshow("测试窗口", img);
// 等待按键输入，按任意键关闭窗口
waitKey(0);
// 销毁所有窗口
destroyAllWindows();
return 0;
}
将代码中的图片路径替换为本地实际存在的图片路径，编译运行项目，如果弹出显示图片的窗口，说明OpenCV环境配置成功，库可以正常使用。
常见问题排查
- 如果编译时提示找不到头文件，检查包含目录配置是否正确，路径是否和实际安装路径一致
- 如果运行时提示缺少opencv_world480d.dll，检查系统环境变量是否配置正确，或者将对应的dll文件复制到项目可执行文件所在目录
- 如果图片读取失败，检查图片路径是否正确，路径中的斜杠要使用正斜杠/或者双反斜杠\