Ubuntu下VS Code中C++项目无法链接OpenCV问题求助

我帮你分析下，你遇到的这些undefined reference错误本质是编译时只包含了OpenCV的头文件，但没有链接对应的库文件——编译器能找到函数的声明，但链接阶段找不到函数的实现代码，所以报错了。下面是具体的修复步骤：

1. 修复tasks.json的编译命令 #

你的tasks.json里的g++命令只编译了源文件，完全没加OpenCV的库链接参数。最简单的解决方式是用pkg-config工具自动获取OpenCV的编译和链接参数，它会帮你处理路径依赖问题。

修改后的tasks.json示例：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "build opencv project",
            "type": "shell",
            "command": "g++",
            "args": [
                "-g",
                "canny.cpp",
                "-o",
                "canny", // 指定输出的可执行文件名
                `$(pkg-config --cflags --libs opencv4)` // OpenCV4用这个，OpenCV3改成opencv
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": ["$gcc"]
        }
    ]
}

小提示： #

• 如果终端执行pkg-config --cflags --libs opencv4提示“package not found”，说明你装的是OpenCV3，把参数改成$(pkg-config --cflags --libs opencv)即可。
• 要是你没装pkg-config，先执行sudo apt install pkg-config安装它。

2. 修正c_cpp_properties.json的头文件路径 #

从你的错误信息里能看到头文件是从/usr/local/include/opencv2读取的，说明你的OpenCV默认安装在/usr/local路径下，而不是你配置的/opt/opencv。调整includePath如下：

{
    "configurations": [
        {
            "name": "Linux",
            "browse": {
                "path": [
                    "/usr/local/include",
                    "${workspaceFolder}"
                ],
                "limitSymbolsToIncludedHeaders": true
            },
            "includePath": [
                "/usr/local/include/opencv4", // OpenCV4的头文件根路径，OpenCV3直接写/usr/local/include即可
                "/usr/local/include",
                "${workspaceFolder}/**"
            ],
            "defines": [],
            "compilerPath": "/usr/bin/gcc",
            "cStandard": "c11",
            "cppStandard": "c++17",
            "intelliSenseMode": "clang-x64"
        }
    ],
    "version": 4
}

验证路径是否正确： #

可以在终端执行find /usr/local/include -name opencv2，如果输出是/usr/local/include/opencv2，那includePath里加/usr/local/include就行；如果是/usr/local/include/opencv4/opencv2，就加/usr/local/include/opencv4。

3. 编译运行验证 #

按Ctrl+Shift+B执行build任务，编译成功后，在终端里运行./canny，如果能正常输出"Hello World"且没有报错，说明问题已经解决了。

如果你的OpenCV是手动编译安装到/opt/opencv的，那需要先设置pkg-config的路径：

export PKG_CONFIG_PATH=/opt/opencv/lib/pkgconfig

之后再执行编译任务即可。

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