OpenCV在Visual Studio中的完整配置教程

前言

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 <opencv2/opencv.hpp>
#include <iostream>

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 中。