VS Code中使用OpenCV构建项目失败：存在未定义引用错误

核心问题原因 #

你使用MinGW的g++编译项目，但vcpkg默认安装的x64-windows triplet是MSVC版本的OpenCV，二者二进制不兼容，导致链接时无法找到符号；另外imread函数属于opencv_imgcodecs模块，你当前仅链接了core和highgui库，缺少必要的依赖模块。

解决方案 #

1. 用vcpkg安装MinGW兼容的OpenCV #

打开终端，运行以下命令安装适配MinGW的OpenCV版本（静态/动态库二选一）：

# 安装静态库（推荐，无需额外处理DLL文件）
vcpkg install opencv:x64-mingw-static

# 或安装动态库
vcpkg install opencv:x64-mingw

2. 修改tasks.json配置 #

更新头文件、库路径，补充必要的链接库，并指定匹配的C++标准：

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++.exe build active file",
            "command": "C:\\Users\\user\\gcc\\bin\\g++.exe",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "-std=c++17", // 指定C++标准，匹配OpenCV编译标准
                "${file}",
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe",
                "-I", "C:\\dev\\vcpkg\\installed\\x64-mingw\\include", // 替换为MinGW版本的include路径
                "-L", "C:\\dev\\vcpkg\\installed\\x64-mingw\\lib", // 替换为MinGW版本的lib路径
                // 补充imgcodecs库，按MinGW链接顺序调整（依赖库放在后方）
                "-lopencv_imgcodecs4",
                "-lopencv_highgui4",
                "-lopencv_core4"
            ],
            "options": {
                "cwd": "C:\\Users\\user\\gcc\\bin"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "Task generated by Debugger."
        }
    ],
    "version": "2.0.0"
}

3. 动态库额外处理（若安装动态版） #

将C:\dev\vcpkg\installed\x64-mingw\bin目录添加到系统环境变量PATH，或是将该目录下的opencv_*.dll文件复制到你的exe输出目录（即main.exe所在文件夹），否则运行程序会提示找不到依赖DLL。

验证编译 #

重新运行“Debug C/C++ file”，此时链接错误应可解决。

内容的提问来源于stack exchange，提问作者qweqq1699