Win10下基于VS2019的OpenCV4.5.2环境配置全攻略（含预编译与手动编译）

张开发
• 2026/4/15 4:08:12 • 15 分钟阅读

最新文章

推荐文章

相关文章

分享文章

Win10下基于VS2019的OpenCV4.5.2环境配置全攻略（含预编译与手动编译）
1. 环境准备下载与安装OpenCV4.5.2在Windows 10系统上配置OpenCV开发环境首先需要获取OpenCV4.5.2的安装包。官方提供了两种获取方式预编译版本和源代码版本。对于大多数开发者来说预编译版本是最快捷的选择。你可以直接从OpenCV官网下载opencv-4.5.2-vc14_vc15.exe这个自解压安装包。下载完成后双击运行选择一个合适的安装路径比如D:\Programs\opencv点击Extract按钮等待解压完成。解压后的文件夹中会包含build和sources两个重要目录前者存放了预编译好的库文件后者则是OpenCV的源代码。如果你需要用到一些额外的功能模块比如人脸识别、文本检测等可能需要下载opencv_contrib扩展包。这个扩展包包含了OpenCV官方维护但未包含在主仓库中的模块。下载地址同样可以在OpenCV官网上找到记得选择与主版本匹配的4.5.2版本。下载后将其解压到合适的位置后续手动编译时会用到。2. 配置系统环境变量安装完OpenCV后需要配置系统环境变量让其他程序能够找到OpenCV的库文件。右键点击此电脑选择属性→高级系统设置→环境变量。在系统变量中找到Path变量点击编辑添加两个新路径D:\Programs\opencv\build\x64\vc15\bin D:\Programs\opencv\build\x64\vc15\lib注意这里的路径要根据你实际的安装位置进行调整。vc15表示这些库是为Visual Studio 2017/2019编译的。添加完成后建议重启电脑使环境变量生效。你可以打开命令提示符输入set path命令来确认环境变量是否设置成功。3. Visual Studio 2019项目配置打开VS2019创建一个新的控制台项目比如命名为HelloOpenCV。为了让项目能够使用OpenCV需要进行三项关键配置包含目录、库目录和附加依赖项。首先打开属性管理器视图→其他窗口→属性管理器找到Microsoft.Cpp.x64.user属性表。右键选择属性在VC目录下的包含目录中添加D:\Programs\opencv\build\include D:\Programs\opencv\build\include\opencv2然后在库目录中添加D:\Programs\opencv\build\x64\vc15\lib最后在链接器→输入→附加依赖项中添加具体的库文件名。对于Debug配置添加opencv_world452d.lib对于Release配置添加opencv_world452.lib。这里的452对应OpenCV的版本号4.5.2d后缀表示调试版本。4. 手动编译OpenCV4.5.2虽然预编译版本很方便但有时我们需要手动编译OpenCV比如要添加额外的模块或进行自定义设置。手动编译需要先安装CMake工具建议下载3.20以上版本。编译过程大致分为以下几步使用CMake配置生成VS2019解决方案在VS2019中编译生成的解决方案安装编译好的库文件具体操作是打开CMake GUI设置源代码路径sources目录和构建路径新建一个build目录。点击Configure按钮选择Visual Studio 2019作为生成器平台选择x64。配置过程中可以指定OPENCV_EXTRA_MODULES_PATH指向opencv_contrib的modules目录。配置完成后点击Generate生成解决方案。打开生成的OpenCV.sln解决方案在VS2019中选择Release或Debug配置右键解决方案选择生成。这个过程可能需要较长时间1-2小时。编译完成后在CMakeTargets文件夹下找到INSTALL项目右键选择生成进行安装。安装后的文件会放在build目录下的install文件夹中。5. 测试OpenCV环境环境配置完成后需要测试是否工作正常。创建一个简单的程序读取并显示图片#include opencv2/opencv.hpp #include iostream using namespace cv; using namespace std; int main() { Mat img imread(lena.jpg); if(img.empty()) { cout 无法加载图片请检查路径 endl; return -1; } imshow(测试窗口, img); waitKey(0); return 0; }如果一切配置正确运行程序应该能够正常显示图片。如果遇到问题首先检查图片路径是否正确然后确认环境变量和项目配置是否设置到位。常见问题包括库版本不匹配Debug/Release混淆、路径错误、环境变量未生效等。

更多文章