VSCode无gcc是因系统未安装或PATH未配置：Windows推荐choco或msys2自动配路径，macOS用xcode-select或brew install gcc并注意命令名；需检查终端与VSCode终端PATH一致，tasks.json须含-g和group:build，launch.json的program路径须与编译输出完全匹配，IntelliSense报错需通过c_cpp_properties.json配置includePath。
找不到 gcc 命令：先确认编译器真装上了
VSCode 本身不带编译器，它只是个编辑器。你敲 gcc --version 报 command not found，不是 VSCode 配错了，是系统压根没装 GCC 或没加进 PATH。
Windows 用户别直接下 MinGW-w64 官网压缩包——解压完不手动配 PATH，VSCode 就看不见 gcc。推荐用 choco install mingw（需先装 Chocolatey）或直接装 msys2 后运行 pacman -S mingw-w64-ucrt-x86_64-gcc，它会自动注册路径。
macOS 装 Xcode Command Line Tools 就够：xcode-select --install；但注意，它只带 clang，不是 gcc。如果你明确要 gcc（比如依赖 GNU 扩展），得用 brew install gcc，装完实际命令是 gcc-14 这类带版本号的，得软链或改配置。
- 检查是否生效：终端新开一个窗口，输
which gcc或gcc --version - VSCode 终端继承的是 shell 的
PATH，如果终端里能跑gcc，但 VSCode 集成终端里不能，说明 VSCode 没读对 shell 配置（比如 macOS 上用了 zsh 但 VSCode 启动时读了 bash） - Windows 用户如果用 PowerShell 启动 VSCode，记得在 PS 里也验证过
gcc可用，别只在 CMD 里试
tasks.json 编译任务写不对，按 Ctrl+Shift+B 没反应
VSCode 的构建功能靠 .vscode/tasks.json 驱动，不是靠插件自动猜。空项目里按 Ctrl+Shift+B 提示“没有任务”，就是缺这个文件。
立即学习“C语言免费学习笔记（深入）”；
最简可用的 tasks.json 不需要一堆字段。重点就三条：label（任务名，随便写）、command（必须是可执行命令，如 gcc）、args（参数顺序很重要）。
常见错法：把 args 写成 ["gcc", "${file}", "-o", "${fileDirname}/${fileBasenameNoExtension}"] —— 这在 Windows 上可能因路径斜杠或空格崩掉；更稳妥的是显式指定输出路径并加引号占位：
{
"version": "2.0.0",
"tasks": [
{
"label": "build C",
"type": "shell",
"command": "gcc",
"args": [
"-g",
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}"
],
"group": "build",
"presentation": { "echo": true, "reveal": "silent" }
}
]
}
-
"type": "shell"比"process"更兼容跨平台路径处理 - 务必加
-g，否则调试时看不到变量值 - 别漏
"group": "build"，不然 Ctrl+Shift+B 找不到它 - 如果源文件名含中文或空格，
${file}会被自动加引号；但某些旧版 MinGW 仍会解析失败，此时改用"${file}"显式包裹（双引号在 JSON 里要转义为\"）
调试时断点不命中：launch.json 和编译选项对不上
能编译通过 ≠ 能调试。断点灰掉、F5 启动后直接退出、变量显示 <optimized out>，八成是编译没带调试信息或优化级别太高。
launch.json 里的 program 必须指向真实生成的可执行文件，且该文件得由带 -g 的命令生成。很多人复制网上模板，却忘了改 program 路径，或者编译用的 gcc 和调试时找的不是同一个。
典型错误配置："program": "${fileDirname}/${fileBasenameNoExtension}.exe"（Windows），但编译任务输出的是 ${fileBasenameNoExtension}（没加 .exe），结果调试器启动了个不存在的文件，静默失败。
- 确保
tasks.json编译命令含-g，且不含-O2、-O3——-O0是安全选项，开发阶段就用它 -
launch.json中program的路径必须和tasks.json里-o指定的完全一致（包括扩展名、大小写） - Windows 下用 MinGW，生成的是
.exe，但program字段值若写成./a.exe，而当前目录不是${fileDirname}，也会找不到 - 第一次调试前，手动在终端跑一遍编译命令，确认可执行文件真生成了，再进 VSCode
C/C++ 插件提示 “无法打开源文件 stdio.h”
这是 IntelliSense（代码补全和跳转）报的错，和编译能否成功无关。即使 gcc 能正常编译，VSCode 也可能找不到头文件路径，导致红色波浪线、#include 灰掉、跳转失效。
根本原因是 C/C++ 插件默认只查系统标准路径，但 MinGW、MSVC、Clang 的头文件位置五花八门。你得告诉它去哪找——靠 c_cpp_properties.json 里的 includePath。
Windows + MinGW-w64 用户，典型路径是 C:/msys64/ucrt64/include 或 C:/mingw64/x86_64-w64-mingw32/include；macOS + Homebrew GCC，则可能是 /opt/homebrew/opt/gcc/include。别瞎猜，用 gcc -v -E -x c /dev/null 看实际搜索路径，找以 search starts here: 开头的那些行。
- 在 VSCode 里按 Ctrl+Shift+P → 输入 “C/C++: Edit Configurations (UI)”，图形界面填比手写 JSON 更少出错
-
includePath里每个路径末尾加/**，表示递归包含子目录（否则stdio.h在stdio子目录下就扫不到） - 如果用了自定义工具链（比如交叉编译），
intelliSenseMode得对应选gcc-arm64或gcc-x64，否则头文件架构不匹配 - 改完配置，右下角点 “Reload Window”，别只关了重开文件夹
