VS Code无法编译调试C/C++是因缺少编译器、插件或环境配置；需依次安装配置MinGW-w64、C/C++与Code Runner插件、建立项目结构、设置IntelliSense路径、配置tasks.json和launch.json实现构建与调试。
如果您已安装 Visual Studio Code，但无法编译或调试 C/C++ 源文件，则可能是由于缺少编译器、未安装必要插件或环境变量未正确配置。以下是解决此问题的步骤：
一、安装并配置 MinGW-w64 编译器
MinGW-w64 是 Windows 平台下 GCC 的移植版本，提供 gcc（C 编译器）和 g++（C++ 编译器），是 VS Code 运行 C/C++ 程序所必需的底层工具链。
1、访问 https://sourceforge.net/projects/mingw-w64/，在 Files 栏中找到最新版 x86_64-posix-seh 架构的离线压缩包（避免使用在线安装器，防止因网络问题失败）。
2、下载完成后解压至不含中文与空格的路径，例如 D:mingw64。
立即学习“C语言免费学习笔记（深入）”；
3、将解压后目录中的 bin 子目录完整路径（如 D:mingw64in）添加到系统环境变量 Path 中：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”→在“系统变量”中选中 Path→“编辑”→“新建”→粘贴路径→全部确定。
4、按 Win + R 输入 cmd，执行命令 gcc -v；若显示版本信息，则说明编译器已就绪。
二、安装 VS Code 必备扩展插件
VS Code 本身不具备语法识别、智能提示与构建能力，需通过扩展插件补全 C/C++ 开发支持功能，其中核心插件负责语言服务、编译任务调度与调试集成。
1、启动 VS Code，点击左侧活动栏的“扩展”图标（或按 Ctrl+Shift+X）。
2、在搜索框中输入 C/C++，选择由 Microsoft 发布的官方插件（ID: ms-vscode.cpptools），点击“安装”。
3、再次搜索 Code Runner，安装 Jun Han 开发的该插件，它支持一键运行单文件（无需手动配置 task.json）。
4、可选：搜索 Chinese 安装简体中文语言包，重启 VS Code 后界面即切换为中文。
三、创建并验证基础 C 项目结构
VS Code 的 C/C++ 支持依赖工作区级配置文件（如 c_cpp_properties.json、tasks.json、launch.json），首次打开文件夹时需建立符合规范的目录结构以触发自动配置流程。
1、在任意磁盘新建空文件夹，例如 D:c_project。
2、在该文件夹内右键→“在终端中打开”，执行命令 code .，用 VS Code 打开当前文件夹作为工作区。
3、在资源管理器中右键→“新建文件”，命名为 hello.c，输入标准代码：
#include <stdio.h>
int main() {
printf("Hello World!\n");
return 0;
}
4、保存文件后，右键编辑区→“运行代码”（Code Runner 提供），或按 Ctrl+Alt+N；若终端输出 Hello World!，则运行通路已验证。
四、手动配置 IntelliSense 头文件路径
当编辑 C 文件时出现 #include 错误：无法打开源文件 "stdio.h"，表明 C/C++ 扩展未能自动定位 MinGW 的标准头文件目录，需显式声明 includePath。
1、按下 Ctrl+Shift+P 打开命令面板，输入并选择 C/C++: Edit Configurations (UI)。
2、在弹出界面中，“Compiler path”栏填写 D:mingw64ingcc.exe（请替换为您的实际路径）。
3、“IntelliSense mode”选择 gcc-x64。
4、在“Include path”列表中点击“Add”，填入 D:mingw64_64-w64-mingw32include 和 D:mingw64libgcc_64-w64-mingw32*include（* 替换为实际子目录名，如 13.2.0）。
5、保存后，重新打开 hello.c，红色波浪线应消失，printf 等函数可被正确识别。
五、配置自定义构建与调试任务
Code Runner 适合快速验证，但正式开发需使用 VS Code 原生 task.json 与 launch.json 实现带调试符号的编译与断点调试，确保生成可调试的 .exe 文件并关联 gdb。
1、按下 Ctrl+Shift+P，输入并选择 Tasks: Configure Default Build Task → “Create tasks.json file from template” → “Others”。
2、将生成的 .vscode/tasks.json 内容替换为：
{
"version": "2.0.0",
"tasks": [
{
"type": "cppbuild",
"label": "gcc build active file",
"command": "D:\mingw64\bin\gcc.exe",
"args": [
"-g",
"${file}",
"-o",
"${fileDirname}\${fileBasenameNoExtension}.exe"
],
"options": {"cwd": "D:\mingw64\bin"},
"problemMatcher": ["$gcc"],
"group": "build"
}
]
}
3、按下 Ctrl+Shift+P，输入并选择 Debug: Open launch.json → “C++ (GDB/LLDB)” → “gcc.exe” → 替换内容为：
{
"version": "0.2.0",
"configurations": [
{
"name": "gcc build and debug active file",
"type": "cppdbg",
"request": "launch",
"program": "${fileDirname}\${fileBasenameNoExtension}.exe",
"args": [],
"stopAtEntry": false,
"cwd": "${workspaceFolder}",
"environment": [],
"externalConsole": true,
"MIMode": "gdb",
"miDebuggerPath": "D:\mingw64\bin\gdb.exe",
"setupCommands": [
{
"description": "Enable pretty-printing for gdb",
"text": "-enable-pretty-printing",
"ignoreFailures": true
}
],
"preLaunchTask": "gcc build active file"
}
]
}
4、按 Ctrl+F5 启动调试，可在 main 函数首行设断点，观察变量值与执行流程。
