Linux VS Code下OpenCV编译报错：undefined reference

你遇到的undefined reference to cv::String::deallocate()属于链接阶段错误，核心原因是编译器没有正确找到并链接OpenCV的C++库，以下是针对性的解决步骤：

1. 替换编译器为g++ #

你的代码是C代码，用gcc编译会跳过C标准库的自动链接，且无法很好兼容OpenCV的C++特性。修改tasks.json中的编译命令：

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++ build active file",
            "command": "/usr/bin/g++", // 把gcc改成g++
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}",
                // 后续链接参数放在这里
            ],
            // 其他配置不变
        }
    ],
    "version": "2.0.0"
}

2. 用pkg-config自动生成链接参数（推荐） #

手动写-lopencv_core等库名容易遗漏或出错，用pkg-config可以自动获取OpenCV的编译和链接参数：

• 先在终端验证pkg-config能否识别OpenCV：

  pkg-config --list-all | grep opencv
  

  如果输出opencv4或opencv，说明可用；如果提示找不到，先添加OpenCV的pkg-config路径到环境变量：

  # 假设你的OpenCV编译后lib/pkgconfig路径是/home/XXXX/opencv/lib/pkgconfig
  export PKG_CONFIG_PATH=/home/XXXX/opencv/lib/pkgconfig:$PKG_CONFIG_PATH
  

• 修改tasks.json的args，并开启shell解析：

  "args": [
      "-fdiagnostics-color=always",
      "-g",
      "${file}",
      "-o",
      "${fileDirname}/${fileBasenameNoExtension}",
      "`pkg-config --cflags --libs opencv4`" // 自动获取编译链接参数
  ],
  "options": {
      "cwd": "${fileDirname}",
      "shell": true // 开启shell才能解析反引号中的命令
  }
  

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

原配置只包含了opencv2子目录，需要补充OpenCV根目录的include路径，确保IntelliSense能找到所有头文件：

{
    "configurations": [
        {
            "name": "Linux",
            "includePath": [
                "/home/XXXX/opencv/include/**", // 替换为你的OpenCV根include目录
                "${workspaceFolder}/**",
                "/usr/local/include/**"
            ],
            "compilerPath": "/usr/bin/g++", // 同步改成g++
            // 其他配置不变
        }
    ],
    "version": 4
}

4. 手动链接（备选方案） #

如果不想用pkg-config，可以手动指定库路径和完整的OpenCV库列表：

"args": [
    "-fdiagnostics-color=always",
    "-g",
    "${file}",
    "-o",
    "${fileDirname}/${fileBasenameNoExtension}",
    "-L/home/XXXX/opencv/lib", // 指定OpenCV库所在目录
    "-lopencv_core",
    "-lopencv_imgproc",
    "-lopencv_highgui",
    "-lopencv_imgcodecs" // 根据需要添加更多库
]

完成以上修改后，重新编译代码即可解决链接错误。

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