在Visual Studio中配置OpenCV for C++的开发环境，需要完成OpenCV库准备、项目属性设置、环境变量配置几个核心步骤，整个过程操作并不复杂，只要按照流程逐步操作就能顺利完成。
准备工作
首先需要下载对应版本的OpenCV库，建议选择Windows平台的预编译版本，下载完成后解压到没有中文和空格的路径下，比如解压到D盘的OpenCV文件夹中。同时要保证已经安装了Visual Studio，建议选择2019及以上版本，安装时勾选使用C++的桌面开发工作负载。
配置项目属性
打开Visual Studio，新建一个空的控制台C++项目，然后按照以下步骤配置项目属性：
配置包含目录
右键点击项目，选择属性，在属性页中先将配置改为所有配置，平台改为所有平台。然后找到VC++目录下的包含目录，添加OpenCV解压路径下的build/include和build/include/opencv2两个路径。
配置库目录
同样在VC++目录下找到库目录，添加OpenCV解压路径下对应Visual Studio版本的lib路径，比如使用的是Visual Studio 2019的64位编译环境，就添加build/x64/vc16/lib路径。
配置链接器输入
展开链接器选项，找到输入下的附加依赖项，添加对应的lib文件名。如果是Debug模式，添加带d后缀的lib文件，比如opencv_world460d.lib；如果是Release模式，添加不带d后缀的lib文件，比如opencv_world460.lib。这里的460是OpenCV的版本号，需要根据实际下载的版本调整。
配置系统环境变量
右键点击此电脑，选择属性，进入高级系统设置，点击环境变量，在系统变量的Path中添加OpenCV的bin路径，比如build/x64/vc16/bin。添加完成后需要重启Visual Studio才能让环境变量生效。
测试配置是否成功
完成上述配置后，可以编写一段简单的测试代码验证环境是否可用，代码如下：
#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 for C++的环境已经配置成功，接下来就可以开展图像处理相关的开发工作了。
常见问题说明
- 如果编译时提示找不到opencv2相关的头文件，检查包含目录的配置是否正确，路径是否和实际解压的OpenCV路径一致。
- 如果运行时提示找不到opencv_world相关的dll文件，检查环境变量是否配置正确，或者将对应的dll文件复制到项目生成的可执行文件所在目录。
- 注意平台配置要和编译选择的平台一致，比如选择x64编译，那么库目录也要选择x64对应的路径，否则会出现链接错误。
OpenCVC++Visual_Studio环境配置修改时间：2026-07-11 20:39:19