VS Code 中不存在“C 工程”概念，仅通过文件夹加三个配置文件（c_cpp_properties.json、tasks.json、launch.json）模拟项目行为；它们必须置于.vscode/目录下，缺一将导致无提示、报红、无法编译或调试失败。
VS Code 里没有“C 工程”这个概念，只有文件夹 + 配置
VS Code 本身不管理工程结构，它只打开一个文件夹，靠 c_cpp_properties.json、tasks.json、launch.json 这三个配置文件模拟 C 项目的构建和调试行为。你新建的不是“工程”，而是一个带正确配置的普通文件夹。
- 直接用
mkdir my_project && cd my_project创建空文件夹，再用 VS Code 打开它（code .） - 别去搜“新建 C 工程模板”——官方插件不提供这种东西，第三方模板往往配错
intelliSenseMode或路径变量 - 如果已有多个
.c文件，确保它们都在同一文件夹或子文件夹下，否则include路径和自动补全容易失效
必须手动配齐的三个 JSON 文件怎么写
缺任何一个，都会导致：代码没提示、#include 报红、按 F5 没反应、或者编译报 undefined reference。它们的位置统一在 .vscode/ 子目录下。
-
c_cpp_properties.json：告诉 IntelliSense 你的编译器在哪、头文件路径、宏定义。关键是compilerPath必须填绝对路径，比如/usr/bin/gcc（Linux/macOS）或C:\msys64\ucrt64\bin\gcc.exe（Windows + MSYS2） -
tasks.json：定义 Ctrl+Shift+B 干什么。别选“Others”模板，直接选“C Makefile”或“GCC Build Active File”；如果多文件，args里要加-o输出可执行名，否则默认只生成.o -
launch.json：调试用。program字段必须指向编译后的真实可执行文件路径（如"./a.out"），不能写"${fileBasenameNoExtension}"—— 它不会自动拼扩展名
常见错误现象和对应检查点
这些不是报错，而是“看起来正常但实际跑不通”的典型信号：
- 所有
printf都标灰、跳转不到定义 → 检查c_cpp_properties.json里configurationProvider是否误删，或includePath漏了/usr/include类路径 - Ctrl+Shift+B 显示 “任务不存在” →
tasks.json顶层少了"version": "2.0.0"，或type写成了"shell"却没配command - F5 启动后黑窗一闪而退 →
launch.json的externalConsole设为true（Windows）或删掉该字段（macOS/Linux），否则程序结束控制台立刻关闭 - 修改代码后调试还是旧结果 → 没在
tasks.json的group里设"build"，导致调试前没自动构建
MinGW / MSYS2 / WSL 下路径写法差异
Windows 用户最容易在这里翻车：VS Code 在不同终端环境下对路径斜杠、空格、盘符的处理完全不同。
立即学习“C语言免费学习笔记（深入）”；
- 用 MinGW-w64（官网下载）：
compilerPath填C:\mingw64\bin\gcc.exe，双反斜杠是必须的；includePath里不要写C:mingw64include，要用正斜杠C:/mingw64/include - 用 MSYS2：路径一律用 Unix 风格，
compilerPath是C:\msys64\ucrt64\bin\gcc.exe，但includePath要写成"C:/msys64/ucrt64/include" - 用 WSL：VS Code 必须装 Remote - WSL 插件，然后从 WSL 环境里打开文件夹；此时所有路径按 Linux 处理，
compilerPath就是/usr/bin/gcc，别混用 Windows 路径
跨环境复制配置时，compilerPath 和 includePath 几乎肯定要重写，别图省事直接粘贴。
