VSCode头文件标红、跳转失败、补全失效主因是c_cpp_properties.json中includePath未正确配置；必须包含${workspaceFolder}/**以递归扫描项目内所有头文件，并准确添加编译器真实系统路径（如/usr/include/c++/11）、第三方库路径及compilerPath，修改后须手动重启IntelliSense引擎。
VSCode里头文件标红、跳转失败、补全不工作，90%是因为 c_cpp_properties.json 的 includePath 没配对——它只管编辑器的“感知”，不管编译器实际能不能找到。
includePath 里必须写 ${workspaceFolder}/**，不是 ${workspaceFolder}/
前者递归扫描整个项目目录（含所有子文件夹里的 .h），后者只查根目录一层。ROS、muduo、Boost 这类库的头文件往往嵌套在 include/muduo/net/InetAddress.h 或 boost/asio.hpp 这种路径下，不加 /** 就永远找不到。
-
${workspaceFolder}/**：正确，覆盖src/、include/、third_party/下所有头文件 -
${workspaceFolder}/include：只扫一级，include/utils/string_util.h会漏掉 -
/usr/include/**：Linux 系统头可加，但 macOS 或 Windows 需换路径，且不是所有系统都支持/**在系统路径下生效（建议只用于项目路径）
系统头和第三方库路径不能靠猜，得查编译器真实用的
你写的 #include <vector> 能不能高亮，取决于 c_cpp_properties.json 里有没有把 g++ 实际装 STL 头的路径列进去。直接写 /usr/include 不够，g++ 通常还会用到 /usr/lib/gcc/x86_64-linux-gnu/11/include/ 和 /usr/include/c++/11/ 这类路径。
- 运行
g++ -v -E -x c++ /dev/null -o /dev/null，看输出末尾的#include <...> search starts here:区域 - 把列出的每一行都加进
includePath数组（注意路径中空格要转义或用引号） - ROS 用户必须显式加
/opt/ros/<code>noetic/include（noetic 换成你自己的版本，如foxy、humble）
compilerPath 必须指向真实可执行文件，不能只写 g++
c_cpp_properties.json 里 compilerPath 设错，IntelliSense 就不会自动推导 STL 路径，哪怕 includePath 全写对了，std::string 依然灰、#include <string> 依然红。
- Linux/macOS：填绝对路径，如
/usr/bin/g++或/usr/bin/clang++ - Windows MinGW：必须是完整路径，如
D:/mingw64/bin/g++.exe，不能只写g++.exe - 路径里有空格？用正斜杠
/，别用单反斜杠\（JSON 会解析失败） - 不确定路径？终端里运行
which g++或where g++（Windows）
别把 tasks.json 的 -I 当成 c_cpp_properties.json 的 includePath
你在 tasks.json 里加 -I/usr/local/include 是给编译器看的，c_cpp_properties.json 里的 includePath 是给 IntelliSense 看的——两者必须各自配，缺一不可。常见错误是只改了一个，结果“能编译但编辑器报错”或“编辑器不报错但编译失败”。
- 编译失败提示
No such file or directory？检查tasks.json的args里有没有对应-I - 编辑器标红但编译成功？回头检查
c_cpp_properties.json的includePath是否漏了路径 - ROS2 用户特别注意：
/opt/ros/foxy/include这类路径必须同时出现在两个文件里，只是写法不同：c_cpp_properties.json用 JSON 数组，tasks.json用-I参数
最常被忽略的一点：c_cpp_properties.json 改完后，VSCode 不会自动重载 IntelliSense 数据库。手动触发一次 C/C++: Restart IntelliSense Engine（Ctrl+Shift+P），否则改了也白改。
