VSCode报“找不到头文件”是IntelliSense路径配置问题，非编译错误；应通过C/C++: Edit Configurations (UI)生成c_cpp_properties.json，检查includePath是否含正确绝对路径、系统头路径及${workspaceFolder}变量，确保compilerPath匹配实际编译器，并重启IntelliSense引擎。
VSCode报“找不到头文件”不是编译失败，而是 IntelliSense 没拿到正确的头文件路径——includePath 配错、没配、或被其他配置覆盖了。代码照样能编译通过，但跳转、补全、红波浪线全崩。
怎么快速生成并检查 c_cpp_properties.json
别手动建文件，容易格式出错。按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 C/C++: Edit Configurations (UI)，回车。VSCode 会自动在 .vscode/ 下生成标准 JSON，并打开图形界面。
- 如果没反应，先确认已安装官方 C/C++ 扩展（ID：
ms-vscode.cpptools） - 生成后立刻检查
.vscode/c_cpp_properties.json是否存在且非空；空文件或只有{}说明生成失败 - 右下角状态栏点
C/C++，确认当前激活的是你刚配的 configuration（比如Win32或Linux），不是Default
includePath 里该填什么、不该填什么
它是一个路径数组，每项必须是完整绝对路径或带 ${workspaceFolder} 的合法变量表达式。IntelliSense 不支持 glob 通配符（如 /usr/include/**），但支持 ** 表示递归子目录（仅用于末尾）。
- 系统标准库路径必须显式加上：
/usr/include/c++/11（Ubuntu）、/opt/homebrew/opt/llvm/include/c++/v1（macOS M1 + Homebrew LLVM）、C:/Program Files/mingw64/x86_64-w64-mingw32/include/c++（MinGW） - 项目内头文件用
"${workspaceFolder}/include"或"${workspaceFolder}/src/include"，别漏掉${workspaceFolder}前缀 - 第三方库路径要指向包含头文件的父目录：OpenCV 要加
/usr/include/opencv4（不是/usr/include/opencv4/opencv2），GLFW 要加含GLFW/glfw3.h的那个include目录 - 删掉所有带
*的路径（如/usr/include/c++/*），VS Code 不识别；也别写./include，相对路径无效
为什么改了 includePath 还是不生效
最常见原因是 compilerPath 没配对，或 configurationProvider 接管了配置。
-
compilerPath必须指向你实际使用的编译器（如/usr/bin/gcc或/usr/bin/clang），否则 IntelliSense 无法推导系统头路径 - 如果用了
CMake Tools或clangd，它们可能通过compile_commands.json或.clangd提供自己的路径，此时c_cpp_properties.json会被忽略 - ROS 或 eBPF 项目中，环境变量（如
ROS_PACKAGE_PATH）未被 VSCode 继承，需在tasks.json中source环境脚本，或改用clangd+compile_commands.json
Clangd 用户特别注意：VSCode 默认 C/C++ 插件和 Clangd 冲突
Clangd 是独立语言服务器，不读 c_cpp_properties.json，它只认 .clangd 或全局 config.yaml。
- 项目根目录建
.clangd，内容示例：CompileFlags: Add: [-I${workspaceFolder}/include, -I/usr/include/opencv4] - 全局配置（Windows）：在
C:\Users\你的用户名\AppData\Local\clangd\config.yaml里写路径 - 确保
compile_commands.json存在且路径正确，Clangd 优先依赖它；运行bear -- make或cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=1 ..生成
真正麻烦的从来不是路径本身，而是多个配置源（c_cpp_properties.json、.clangd、compile_commands.json、环境变量）之间谁生效、谁覆盖谁。开一个新窗口，关掉所有插件再逐个启用，比瞎调路径更省时间。
