Jetson Xavier AGX下VS Code C++调用OpenCV报头文件缺失错误

报错核心是两个C++新手常见配置误区：

1. c_cpp_properties.json 仅负责VS Code的代码跳转、语法提示，完全不参与实际C++代码的编译链接流程，仅修改这个文件无法解决编译阶段的头文件找不到问题。
2. Ubuntu环境下通过apt或JetPack安装的OpenCV4，头文件实际存放在/usr/include/opencv4/opencv2/目录，没有直接挂载到系统默认头文件搜索路径下，编译时如果没指定对应头文件搜索路径、没链接对应OpenCV库，就会触发找不到头文件的报错。

第一步：验证本机OpenCV开发环境完整性 #

终端执行以下命令验证安装状态：

# 查询OpenCV头文件搜索参数
pkg-config --cflags opencv4
# 查询OpenCV链接库参数
pkg-config --libs opencv4

正常执行后会输出类似以下内容，代表安装无异常：

-I/usr/include/opencv4
-lopencv_highgui -lopencv_imgcodecs -lopencv_core（后续省略其他链接库参数）

如果执行命令报错，先补装OpenCV开发组件：

sudo apt update
sudo apt install libopencv-dev

第二步：修正VS Code智能提示配置（解决编辑区代码飘红问题） #

打开项目目录下的.vscode/c_cpp_properties.json，将配置修改为以下内容，注意Jetson为arm64架构，智能提示模式要匹配对应架构：

{
    "configurations": [
        {
            "name": "Linux",
            "includePath": [
                "${workspaceFolder}/**",
                "/usr/include/opencv4"
            ],
            "defines": [],
            "compilerPath": "/usr/bin/g++",
            "cStandard": "c17",
            "cppStandard": "c++17",
            "intelliSenseMode": "linux-gcc-arm64"
        }
    ],
    "version": 4
}

第三步：配置编译参数（解决实际运行时报错问题） #

根据你使用的编译方式选择对应配置即可：

• 终端直接g++编译
  编译命令必须带上pkg-config自动获取的OpenCV参数，不要手动硬编码路径，示例命令：

  g++ your_code.cpp -o your_app `pkg-config --cflags --libs opencv4`
  

  注意命令中包裹pkg-config语句的是反引号（键盘左上角Esc下方的按键），不是单引号，作用是自动将查询到的头文件路径、链接库参数插入编译命令。

• VS Code内按F5/Ctrl+Shift+B编译运行
  修改.vscode/tasks.json的编译参数，把OpenCV配置加入编译指令，示例配置：

  {
      "tasks": [
          {
              "type": "cppbuild",
              "label": "C/C++: g++ 生成活动文件",
              "command": "/usr/bin/g++",
              "args": [
                  "-fdiagnostics-color=always",
                  "-g",
                  "${file}",
                  "-o",
                  "${fileDirname}/${fileBasenameNoExtension}",
                  "`pkg-config", "--cflags", "--libs", "opencv4`"
              ],
              "options": {
                  "cwd": "${fileDirname}"
              },
              "problemMatcher": [
                  "$gcc"
              ],
              "group": {
                  "kind": "build",
                  "isDefault": true
              }
          }
      ],
      "version": "2.0.0"
  }
  

• CMake管理项目
  在项目根目录的CMakeLists.txt中加入OpenCV查找与链接配置：

  cmake_minimum_required(VERSION 3.10)
  project(opencv_test)
  set(CMAKE_CXX_STANDARD 17)
  find_package(OpenCV REQUIRED)
  include_directories(${OpenCV_INCLUDE_DIRS})
  add_executable(opencv_test your_code.cpp)
  target_link_libraries(opencv_test ${OpenCV_LIBS})
  

配置验证 #

写入以下测试代码验证配置是否生效：

#include <opencv2/opencv.hpp>
#include <iostream>
int main() {
    std::cout << "OpenCV version: " << CV_VERSION << std::endl;
    return 0;
}

编译运行后正常输出OpenCV版本号即代表配置全部完成。

内容的提问来源于stack exchange，提问作者Aleks-CST