如何在VS Code中配置自行编译的OpenCV（含opencv_contrib）

首先明确：你跳过的「安装」步骤才是让系统/编辑器能找到OpenCV文件的核心环节，先补做安装，再配置VS Code的两个扩展即可解决问题。

1. 补做OpenCV安装 #

回到你之前编译OpenCV的build目录：

• Linux/macOS：终端执行

  sudo make install
  

  默认会把OpenCV头文件放到/usr/local/include/opencv4，库文件放到/usr/local/lib
• Windows：如果用CMake生成了VS解决方案，打开解决方案找到INSTALL项目，右键选「生成」；如果用MinGW编译，在build目录执行mingw32-make install，默认安装路径一般是C:\opencv\build类位置

2. 配置C/C++扩展（智能提示用） #

按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入「C/C++: Edit Configurations (JSON)」打开.vscode/c_cpp_properties.json，修改以下项：

• 在includePath数组里添加OpenCV头文件路径，比如：
  Linux/macOS："/usr/local/include/opencv4/**"
  Windows："C:/opencv/build/include/opencv4/**"
• 确保compilerPath指向你正在使用的编译器（比如gcc、clang或MSVC的cl.exe）
• browse.path里也加上同样的头文件路径，保证智能提示能识别OpenCV的类和函数

3. 配置C/C++ Runner扩展（编译运行用） #

打开.vscode/settings.json（可通过Ctrl+,打开设置后，点击右上角「打开设置(JSON)」），添加对应平台的编译链接参数：

• Linux/macOS：

  "c-cpp-runner.compilerArgs": [
      "-I/usr/local/include/opencv4",
      "-L/usr/local/lib",
      "-lopencv_core",
      "-lopencv_imgproc",
      "-lopencv_highgui",
      "-lopencv_imgcodecs"
  ]
  

  若用到opencv_contrib里的模块（比如xfeatures2d、tracking），在后面追加对应库参数，比如-lopencv_xfeatures2d
• Windows（MSVC为例）：

  "c-cpp-runner.compilerArgs": [
      "-IC:/opencv/build/include/opencv4",
      "-LC:/opencv/build/x64/vc16/lib",
      "-lopencv_world480d.lib"
  ]
  

  其中480是OpenCV版本号，d代表Debug版本，Release版本去掉d；若用MinGW，库名格式为libopencv_world480.dll.a，参数改为-llibopencv_world480.dll.a

Windows用户额外注意：把OpenCV的动态库路径（比如C:/opencv/build/x64/vc16/bin）加到系统环境变量里，否则运行时会找不到动态库。

验证配置 #

写一段简单代码测试：

#include <opencv2/opencv.hpp>
#include <iostream>

int main() {
    cv::Mat img = cv::imread("test.jpg");
    if (img.empty()) {
        std::cout << "无法读取图片" << std::endl;
        return 1;
    }
    cv::imshow("测试窗口", img);
    cv::waitKey(0);
    return 0;
}

如果能正常弹出窗口显示图片，说明配置成功。

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