VSCode运行C语言：解决头文件找不到的经典难题

VSCode报“找不到头文件”是IntelliSense路径配置问题，非编译错误；应通过C/C++: Edit Configurations (UI)生成c_cpp_properties.json，确保includePath含正确绝对路径、系统头路径及${workspaceFolder}变量，compilerPath匹配真实编译器，并重启IntelliSense引擎。

VSCode报“找不到头文件”不是编译失败，是IntelliSense没拿到路径

代码能正常 gcc 编译通过，但编辑器里 #include <stdio.h> 下全是红波浪线——这说明问题出在 IntelliSense 引擎，不是编译器。它压根没被告诉去哪找头文件，c_cpp_properties.json 里的 includePath 没配对或根本没生效。

别手写 c_cpp_properties.json，用 UI 界面生成再改

手动建 JSON 容易格式错、漏逗号、引号不匹配，直接废掉整个配置。正确做法是：

• 按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）
• 输入 C/C++: Edit Configurations (UI)，回车
• 确认已安装官方 C/C++ 扩展（ID: ms-vscode.cpptools），否则命令不出现
• 生成后立刻检查 .vscode/c_cpp_properties.json 是否存在且内容非空；空文件或只有 {} 就是失败

生成完别急着关窗口，先点右下角状态栏的 C/C++，确保当前激活的是你刚配的 configuration（比如 Linux），不是 Default 或 Win32。

includePath 必须填绝对路径，不能写 ./include 或 /usr/include/**

includePath 是个字符串数组，每项必须是完整绝对路径，或带 ${workspaceFolder} 的合法变量表达式。常见错误有：

立即学习“C语言免费学习笔记（深入）”；

• 写 ./include：相对路径无效，IntelliSense 不认
• 写 /usr/include/c++/*：通配符 * 不支持，只支持末尾的 ** 表示递归（如 /usr/include/c++/11/**）
• 漏系统头路径：Ubuntu 必加 /usr/include、/usr/include/x86_64-linux-gnu；macOS M1 + Homebrew LLVM 要加 /opt/homebrew/opt/llvm/include/c++/v1
• 第三方库路径填错层级：OpenCV 要填 /usr/include/opencv4，不是 /usr/include/opencv4/opencv2；GLFW 要填含 GLFW/glfw3.h 的那个 include 目录本身

compilerPath 配不对，includePath 再全也没用

IntelliSense 会根据 compilerPath 自动推导部分系统头路径。如果这里只写 g++ 或 clang，它 fallback 到默认逻辑，大概率推错。

• 运行 which gcc 或 which clang++ 拿到真实路径，填进配置（如 /usr/bin/gcc、/usr/bin/clang++）
• 如果你用了 CMake Tools 插件且项目有 CMakeLists.txt，c_cpp_properties.json 里的 includePath 默认被忽略——删掉或注释掉 "configurationProvider": "ms-vscode.cmake-tools"
• 改完配置后，必须重启 IntelliSense：按 Ctrl+Shift+P → C/C++: Restart IntelliSense Engine，否则不生效

最常被忽略的一点：IntelliSense 和真实编译器是两套路径体系。你用 gcc -I/path/to/headers 能编过，不代表 VSCode 知道这个 -I；它只认 c_cpp_properties.json 里的 includePath。两者脱节，就必然红波浪线。