如何在Visual Studio中配置OpenCV for c++ 图像处理环境搭建【入门教程】

8次阅读

在 Visual Studio 中配置 OpenCV(C++)需三步:①解压官方预编译包至无中文无空格路径;②在项目属性中设置包含目录、库目录及附加依赖项;③将 DLL 复制到可执行文件目录或添加 PATH。配置后运行示例代码可验证成功。

如何在 Visual Studio 中配置 OpenCV for c++ 图像处理环境搭建【入门教程】

在 Visual Studio 中配置 OpenCV(C++ 版)环境,核心是让编译器能找到头文件、链接器能调用动态库、运行时能加载 DLL。不依赖 CMake GUI 或 vcpkg 也能完成,适合初学者理解底层逻辑。

下载并 解压 OpenCV 官方预编译包

访问 OpenCV 官网 Releases 页面,下载 Windows 平台的 winpack(.exe)版本(如 opencv-4.9.0-vc14_vc15.exe)。双击运行,选择一个 ** 无中文、无空格的路径解压 **(例如 D:opencv)。解压后你会看到:
buildinclude:存放所有头文件(opencv2/…)
buildx64vc17bin:存放运行时需要的 DLL(如 opencv_world490.dll)
buildx64vc17lib:存放链接用的 .lib 文件(如 opencv_world490.lib)
注意:vc17 对应 Visual Studio 2022;若用 VS2019,请选 vc16 目录;VS2017 选 vc15。

在 VS 项目中配置包含目录与库目录

打开你的 C++ 项目 → 右键项目名 → 属性 → 切换到 配置:Debug + 平台:x64(务必确认平台是 x64,OpenCV 预编译包默认不支持 Win32):
– 在 C/C++ → 常规 → 附加包含目录 中添加:
D:opencvbuildinclude
– 在 链接器 → 常规 → 附加库目录 中添加:
D:opencvbuildx64vc17lib
– 在 链接器 → 输入 → 附加依赖项 中添加(以 OpenCV 4.9.0 为例):
opencv_world490.lib
(若用 Debug 模式,部分老版本需加 d 后缀,如 opencv_world490d.lib;新版统一用无 d 版本即可)

设置 DLL 路径,避免运行时报“找不到 opencv_worldxxx.dll”

有两种可靠方式任选其一:
方法一(推荐):把 DLL 复制到可执行文件目录
编译后生成的 .exe 默认在 项目目录 x64Debug 下,将 D:opencvbuildx64vc17bin*.dll 全部复制进去。
方法二:添加系统 环境变量
D:opencvbuildx64vc17bin 加入系统 PATH(需重启 VS 生效),但不建议新手用,容易污染环境或引发版本冲突。

写一段代码验证是否成功

在 main.cpp 中粘贴以下最小示例:

#include  #include   int main() {     cv::Mat img = cv::Mat::ones(100, 100, CV_8UC3);     std::cout <<"OpenCV version:" << CV_VERSION << std::endl;     cv::imshow("Test", img);     cv::waitKey(0);     return 0; }

点击运行。如果控制台输出版本号、弹出一个白色窗口,说明配置完全成功。
⚠️ 若报错“未定义的引用”或“LNK2019”,检查:lib 名字拼写、平台是否为 x64、Debug/Release 模式是否匹配 lib 类型。

不复杂但容易忽略:每次新建项目都要重复配置一次属性页;熟练后可用“属性管理器”保存为通用属性表(.props),一键复用。

text=ZqhQzanResources