gcc必须能从任意cmd窗口直接调用，否则VSCode构建调试等全部失败；验证需在原生cmd中运行gcc -v，报错“不是内部或外部命令”说明环境变量未生效，输出版本但提示“无法定位DLL”则安装不完整或路径含空格/中文。
gcc 必须能从任意 cmd 窗口直接调用，否则 VSCode 后续所有构建、调试、智能提示都会失败——这是最常卡住新手的第一关。
验证 gcc 是否真正可用
别只在 VSCode 内置终端里试，必须打开系统原生 cmd 或 powershell，输入：
gcc -v
如果报错“不是内部或外部命令”，说明环境变量没生效；如果输出版本信息但提示“无法定位 DLL”，说明 MinGW 安装不完整或路径含空格/中文。
- MinGW-W64 推荐用 winlibs.com 下载免安装版（解压即用，无注册表污染）
- 解压后路径尽量选纯英文、无空格的目录，例如
C:mingw64，而非C:Program Filesmingw64 - 添加到系统
Path的是bin子目录，例如C:mingw64in，不是上层目录 - 改完环境变量后，必须关闭并重开所有已打开的终端窗口（包括 VSCode 内置终端）
c_cpp_properties.json 中的 compilerPath 怎么填
这个路径不是用来“运行编译”的，而是给 C/C++ 插件做代码补全和语法检查用的。它必须指向一个真实存在的 gcc.exe 或 g++.exe 文件，且该文件能正常响应 --version 参数。
- 填错会导致
#include <stdio.h>标红、函数名不提示、宏定义识别失败 - 正确写法示例：
"compilerPath": "C:\mingw64\bin\gcc.exe"（注意双反斜杠） - 不要填
g++.exe来编译 C 文件——虽然能过，但会误启用 C++ 模式，导致bool、nullptr等被错误识别 - 如果项目混用 C 和 C++，建议分开配置：C 用
gcc.exe，C++ 用g++.exe，并在intelliSenseMode中明确指定gcc-x64或gpp-x64
调试时 launch.json 找不到 gdb.exe
VSCode 调试依赖 GDB，而多数 MinGW-W64 发行版默认不带 gdb.exe，或带的是精简版（缺少 Python 支持，无法启用 pretty-printing）。
立即学习“C语言免费学习笔记（深入）”；
- 先确认
gdb.exe存在：dir C:mingw64ingdb.exe，不存在就换发行版（winlibs 版本自带完整 GDB） -
miDebuggerPath必须是绝对路径，且不能有引号，例如："miDebuggerPath": "C:\mingw64\bin\gdb.exe" - 如果调试时提示“Failed to launch gdb”，大概率是
gdb.exe依赖的 DLL（如libexpat-1.dll）缺失，此时应把整个bin目录加入Path，而不是只加gcc.exe路径 - Windows 上建议设
"externalConsole": true，否则scanf类输入可能卡死
tasks.json 编译失败却没报错信息
常见现象：点击 ▷ 运行，控制台一闪而过，没输出也没生成 .exe，但 VSCode 不报任何错误。
- 问题往往出在
args里漏了${file}，或者误写了"*.c"却没开启 shell 模式（VSCode tasks 不支持通配符展开） - 基础可靠写法：
"args": ["-g", "${file}", "-o", "${fileDirname}\${fileBasenameNoExtension}.exe"] - 加
-Wall -Wextra能暴露隐性错误，比如未初始化变量、隐式类型转换 - 如果源码含中文字符串，务必加
-fexec-charset=UTF-8，否则 Windows 控制台输出乱码 - 不要在
args里写-I却不跟路径，这会导致编译器直接退出而不报错
tasks.json + launch.json，后者走自己封装的命令。混用时，一个改了 gcc 路径，另一个可能还在用旧缓存——建议初期只用 Code Runner 快速验证，确认 gcc 可用后再切到标准调试流程。 
