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

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

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

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

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

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

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

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

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

写一段代码验证是否成功

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

Writecream

AI作家和文案内容生成器

下载

#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），一键复用。