前言
OpenCV（Open Source Computer Vision Library）是一个开源的计算机视觉库，广泛应用于图像处理、计算机视觉和机器学习领域。本教程将详细介绍在Visual Studio中配置OpenCV的完整步骤。
一、环境准备
1.1 软件版本说明
Visual Studio：2017/2019/2022均可（本教程以VS2019为例）
OpenCV：4.2.0版本
操作系统：Windows 10/11 64位
1.2 下载OpenCV
访问OpenCV官网：https://opencv.org/releases/
选择Windows版本下载（如opencv-4.2.0-vc14_vc15.exe）
运行下载的exe文件，将其解压到指定目录（如：E:\SOFT\soft_other\opencv4.2）
二、Visual Studio项目配置
2.1 创建新项目
打开Visual Studio
选择"创建新项目" → "控制台应用" → 输入项目名称
选择项目位置 → 点击"创建"
2.2 配置包含目录
步骤
复制代码
1. 右键点击项目 → 属性
2. 选择"VC++目录" → "包含目录"
3. 点击编辑 → 添加以下路径：
- E:\SOFT\soft_other\opencv4.2\build\include
- E:\SOFT\soft_other\opencv4.2\build\include\opencv2
- D:\SOFT\InstallPackage\eigen-3.4.0 # Eigen库（如果需要）
2.3 配置库目录
步骤
复制代码
1. 在同一个属性页中，选择"库目录"
2. 点击编辑 → 添加以下路径：
- E:\SOFT\soft_other\opencv4.2\build\x64\vc15\lib
# 注意：vc14对应VS2015，vc15对应VS2017/2019
2.4 配置链接器
步骤
复制代码
1. 选择"链接器" → "输入" → "附加依赖项"
2. Debug模式添加：opencv_world420d.lib
3. Release模式添加：opencv_world420.lib
三、系统环境配置
3.1 解决DLL文件缺失问题
如果运行时出现"未找到opencv_world420d.dll"错误，按以下步骤解决：
解决方法
复制代码
1. 找到OpenCV的bin目录：
E:\SOFT\soft_other\opencv4.2\build\x64\vc15\bin
2. 复制该目录下的以下三个DLL文件：
- opencv_world420.dll
- opencv_world420d.dll
- 其他相关DLL文件
3. 粘贴到系统目录：
- C:\Windows\System32（32位系统）
- 或 C:\Windows\SysWOW64（64位系统推荐）
4. 或者更推荐的方法：将bin目录添加到系统PATH环境变量
3.2 添加环境变量（推荐）
步骤
复制代码
1. 右键"此电脑" → 属性 → 高级系统设置
2. 点击"环境变量"
3. 在"系统变量"中找到Path → 编辑
4. 添加OpenCV的bin目录路径
5. 重启Visual Studio使更改生效
四、测试配置
4.1 测试代码
cpp
复制代码
#include
#include
using namespace cv;
using namespace std;
int main()
{
// 创建一个黑色图像
Mat image = Mat::zeros(400, 600, CV_8UC3);
// 在图像上绘制文字
putText(image, "OpenCV Configuration Success!",
Point(50, 200),
FONT_HERSHEY_SIMPLEX,
1.0,
Scalar(0, 255, 0),
2);
// 显示图像
imshow("Test Window", image);
// 等待按键
waitKey(0);
cout << "OpenCV配置成功！" << endl;
return 0;
}
4.2 编译和运行
选择正确的配置：Debug x64 或 Release x64
按F7编译项目
按Ctrl+F5运行程序
五、常见问题解决
5.1 版本不匹配问题
复制代码
错误：LNK1104 无法打开文件"opencv_world420d.lib"
解决：检查OpenCV版本与Visual Studio版本的匹配性
5.2 架构不匹配问题
复制代码
错误：_M_IX86未定义或_M_X64已定义
解决：确保项目平台与OpenCV库平台一致（都是x64）
5.3 运行时错误
复制代码
错误：0x000007b 应用程序无法正常启动
解决：确保所有DLL文件都是同一架构（都是64位）
六、高级配置建议
6.1 使用属性表（推荐）
创建属性表可以避免每次新建项目都要重新配置：
步骤
复制代码
1. 视图 → 其他窗口 → 属性管理器
2. 右键项目 → 添加新项目属性表
3. 配置好包含目录、库目录等设置
4. 保存为OpenCV_Debug.props和OpenCV_Release.props
5. 在新建项目中直接导入属性表
6.2 CMake集成
如果需要使用CMake管理项目：
CMakeLists.txt示例
复制代码
cmake_minimum_required(VERSION 3.10)
project(OpenCV_Test)
find_package(OpenCV REQUIRED)
include_directories(${OpenCV_INCLUDE_DIRS})
add_executable(main main.cpp)
target_link_libraries(main ${OpenCV_LIBS})
七、总结
通过以上步骤，你应该已经成功在Visual Studio中配置好了OpenCV开发环境。主要注意以下几点：
版本一致性：确保VS版本与OpenCV的vc版本匹配
平台一致性：确保都是x64或都是Win32
路径正确性：确保所有路径都是实际存在的
环境变量：建议将OpenCV的bin目录添加到系统PATH
八、资源下载
OpenCV官方下载：https://opencv.org/releases/
九、额外补充eigen库配置
python
复制代码
opencv配置：
包含目录：
D:\SOFT\InstallPackage\eigen-3.4.0
E:\SOFT\soft_other\opencv4.2\build\include
E:\SOFT\soft_other\opencv4.2\build\include\opencv2
库目录：
E:\SOFT\soft_other\opencv4.2\build\x64\vc15\lib
链接-->输入：
debug：opencv_world420d.lib
realease：opencv_world420.lib
问题：若报错未找到opencv_world420d.dll或 opencv_world420.dll
方法：把⾃⼰opencv⽂件⽬录下的\opencv\build\x64\vc14\bin中的三个dll⽂件，拷贝到C:\Windows\System32 中。