头文件路径未被IntelliSense找到的主因是c_cpp_properties.json中includePath配置缺失或错误；需检查并正确添加编译器自带路径、第三方依赖路径，匹配工具链设置intelliSenseMode，并在远程开发时使用Remote-WSL配合compileCommands。
头文件路径没被 IntelliSense 找到
VS Code 默认不自动扫描项目外的头文件目录，c_cpp_properties.json 里 includePath 配置缺失或写错是最常见原因。不是编辑器坏了，是它根本不知道去哪找 stdio.h 这类文件。
- 检查
.vscode/c_cpp_properties.json是否存在，不存在就用命令面板运行C/C++: Edit Configurations (UI)生成一个 -
includePath必须包含编译器自带头路径（比如/usr/include、C:/Program Files/mingw64/x86_64-w64-mingw32/include），不能只写项目内./include - Windows 下 MinGW 或 MSVC 路径差异大：
msvc要加Windows Kits目录；MinGW要确认实际安装路径，别直接抄网上的mingw32示例 - 路径末尾不加
/**—— VS Code 的 C/C++ 插件不支持 glob 递归，写成/usr/include/**反而会失效
#include 提示“cannot open source file”但编译能过
这是 IntelliSense 和真实编译器用的路径不一致导致的假报错。编译靠 gcc -I 或 CMakeLists.txt 里的 target_include_directories，而 VS Code 只看 c_cpp_properties.json。
- 如果用 CMake，优先选
configurationProvider：在c_cpp_properties.json里设"configurationProvider": "ms-vscode.cmake-tools"，让插件直接读 CMake 缓存 - 手动配
includePath时，别漏掉 CMake 生成的build/_deps/xxx-src/include这类第三方依赖路径 - 修改后必须点右下角 “C/C++” 状态栏 → 选择新配置，或重启 IntelliSense（Ctrl+Shift+P →
C/C++: Restart Intellisense Engine）
头文件跳转失败或定义跳转到错误位置
跳转不准通常因为符号索引混乱，尤其是用了宏、模板或跨平台条件编译时，IntelliSense 解析逻辑和编译器不完全一致。
- 删掉
.vscode/c_cpp_properties.json里的defines中多余的宏（比如误加了DEBUG=0），宏定义冲突会让解析器选错分支 - 检查
intelliSenseMode是否匹配工具链：用 Clang 就设clang-x64，用 GCC 12 就别选gcc-arm - 大项目建议关掉
"browse.path"（已废弃字段），改用"compileCommands"指向compile_commands.json，更贴近真实构建环境
WSL 或远程开发时头文件全标红
本地 VS Code 无法直接访问 WSL 里 /usr/include 这类路径，必须通过 Remote-SSH / Remote-WSL 插件把整个 C/C++ 环境跑在远端。
- 不要在本地打开 WSL 路径（如
\wsl$Ubuntuhome...），这会让 IntelliSense 用 Windows 视角解析 Linux 头文件，路径和符号全错 - 正确做法：用 Remote-WSL 扩展连接进去，在 WSL 内部打开项目文件夹，此时
c_cpp_properties.json的includePath才能填/usr/include - 远程场景下，
compileCommands比includePath更可靠 —— 先在 WSL 里用 CMake 生成compile_commands.json，再在配置里指定它
最麻烦的其实是多工具链混用：同一个项目既用 GCC 又用 Clang，或者 CI 用交叉编译而本地用原生编译。这时候 c_cpp_properties.json 里得配多套 configuration，且每次切换都要手动点状态栏同步，稍不注意就回到“头文件打不开”的状态。
