MacOS下VSCode编译OpenCV C++代码遇链接错误求助

代码（learning.cpp） #

#include <opencv2/opencv.hpp>
using namespace cv;

Mat loadImage(const std::string& imagePath) {
    Mat image = imread(imagePath, IMREAD_COLOR);
    if (image.empty()) {
        std::cerr << "Failed to load image: " << imagePath << std::endl;
        return Mat();
    }
    return image;
}

int main() {
    std::string imagePath = "sample.jpg";
    Mat image = loadImage(imagePath);
    if (!image.empty()) {
        imshow("Image", image);
        waitKey(0);
    }
    return 0;
}

编译命令 #

g++-11 -std=c++14 -O3 -fopenmp -I/opt/homebrew/Cellar/opencv/4.9.0_2/include/opencv4/ learning.cpp -o exe.learning

错误信息 #

Undefined symbols for architecture arm64:
  "__ZN2cv3MatC1EOS0_", referenced from:
      __Z9loadImageRKNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEE in ccA36q5q.o
  "__ZN2cv3MatC1Ev", referenced from:
      __Z9loadImageRKNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEE in ccA36q5q.o
  "__ZN2cv3MatD1Ev", referenced from:
      __Z9loadImageRKNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEE in ccA36q5q.o
      _main in ccA36q5q.o
  "__ZN2cv6imreadERKNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEEi", referenced from:
      __Z9loadImageRKNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEE in ccA36q5q.o
  "__ZN2cv6imshowERKNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEERKNS_11_InputArrayE", referenced from:
      _main in ccA36q5q.o
  "__ZN2cv7waitKeyEi", referenced from:
      _main in ccA36q5q.o
  "__ZNK2cv3Mat5emptyEv", referenced from:
      __Z9loadImageRKNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEE in ccA36q5q.o
      _main in ccA36q5q.o
ld: symbol(s) not found for architecture arm64
collect2: error: ld returned 1 exit status

解决方法 #

这个错误是因为编译时只指定了头文件路径，没有链接OpenCV的库文件，链接器找不到对应的符号实现。可以用以下几种方法解决：

• 方法1：手动指定库路径和需要的库
  OpenCV通过Homebrew安装后，库文件路径通常在/opt/homebrew/Cellar/opencv/4.9.0_2/lib/。编译命令需要加上-L指定库路径，再加上需要链接的OpenCV库。

  修改后的编译命令：

  g++-11 -std=c++14 -O3 -fopenmp -I/opt/homebrew/Cellar/opencv/4.9.0_2/include/opencv4/ -L/opt/homebrew/Cellar/opencv/4.9.0_2/lib/ learning.cpp -o exe.learning -lopencv_core -lopencv_imgcodecs -lopencv_highgui
  

  • -L<路径>：告诉编译器库文件所在目录
  • -lopencv_core：链接核心库（Mat相关操作依赖）
  • -lopencv_imgcodecs：链接图像编解码库（imread依赖）
  • -lopencv_highgui：链接GUI库（imshow、waitKey依赖）

  如果需要用到其他OpenCV模块（比如imgproc、video等），可以继续添加对应的库，格式为-lopencv_<模块名>。

• 方法2：使用pkg-config自动获取编译参数
  Homebrew安装的OpenCV通常会生成pkg-config配置文件，直接用它来获取所有必要的编译和链接参数，避免手动输入：

  先确认pkg-config能找到OpenCV配置：

  pkg-config --cflags --libs opencv4
  

  如果输出正常，直接把参数代入编译命令：

  g++-11 -std=c++14 -O3 -fopenmp learning.cpp -o exe.learning $(pkg-config --cflags --libs opencv4)
  

  这种方法更省心，会自动包含所有头文件路径和需要链接的库。

• 方法3：在VSCode中配置tasks.json自动编译
  如果经常用VSCode编译，可以编辑.vscode/tasks.json，添加编译任务，把正确的编译参数写进去：

  {
      "version": "2.0.0",
      "tasks": [
          {
              "label": "compile opencv",
              "type": "shell",
              "command": "g++-11 -std=c++14 -O3 -fopenmp ${file} -o ${fileBasenameNoExtension}.out $(pkg-config --cflags --libs opencv4)",
              "args": [],
              "group": {
                  "kind": "build",
                  "isDefault": true
              },
              "problemMatcher": ["$gcc"],
              "detail": "Compile OpenCV C++ code"
          }
      ]
  }
  

  之后按Ctrl+Shift+B就能直接编译当前文件。

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