VS Code 配置 C 语言开发环境(Windows 10/11):从 GCC 安装到运行、断点调试,一篇搞定
适合人群:刚开始学习 C 语言的大一学生、需要配置 C 语言实验环境的同学。本文以 Windows 10/11 为例,使用 VS Code + Microsoft C/C++ 插件 + MSYS2(MinGW-w64 GCC)。
一、先搞清楚:VS Code 为什么不能直接运行 C 语言?
VS Code 是代码编辑器,不自带 C 语言编译器。完整的开发环境需要三部分:
| 工具 | 用途 |
|---|---|
| VS Code | 编写和管理 C 语言代码 |
| Microsoft C/C++ 扩展 | 代码补全、错误提示和调试支持 |
| GCC + GDB | GCC 编译 C 程序,GDB 负责断点调试 |
本文选择 MSYS2 安装 GCC 和 GDB,方便后续更新和管理。
二、安装 VS Code 和 C/C++ 扩展
-
进入 VS Code 官网:https://code.visualstudio.com/ ,下载 Windows 安装包并安装。

!在这里插入图片描述(https://i-blog.csdnimg.cn/direct/343f69e452d04251aa154c8ceeee5e85.png




-
打开 VS Code,按
Ctrl + Shift + X进入扩展商店。

点击安装插件,然后重启VSCODE
-
搜索 C/C++ ,安装发布者为 Microsoft 的扩展。

安装C++和C插件
三、安装 MSYS2 和 GCC 编译器
-
进入 MSYS2 官网:https://www.msys2.org/ ,下载并安装。

-
建议使用默认安装目录
D:\msys64。





输入命令更新:
git
pacman -Syu

输入命令下载GCC 用于编译程序,GDB 用于调试程序:
git
pacman -S --needed mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-gdb
- 从开始菜单打开 MSYS2 UCRT64 终端(不要误用普通的 MSYS 终端)。
四、配置 Windows 的 Path 环境变量
如果希望在 VS Code 的 PowerShell 终端中调用 GCC,需要将下面的目录添加到系统或用户的 Path:

text
D:\msys64\ucrt64\bin
具体操作:
- 按
Win + S,搜索"编辑系统环境变量"。 - 点击"环境变量",在"用户变量"或"系统变量"中选中
Path,点击"编辑"。 - 点击"新建",粘贴
C:\msys64\ucrt64\bin,保存。 - 完全关闭并重新启动 VS Code,使新环境变量生效。






!在这里插入图片描述(https://i-blog.csdnimg.cn/direct/ebb7279cc5c741bda9e68fb341f027ad.png
打开cmd 终端,执行:
powershell
gcc --version
gdb --version
where.exe gcc

where.exe gcc 应当能找到 C:\msys64\ucrt64\bin\gcc.exe。如果电脑里安装过其他 MinGW,需要特别注意路径顺序,避免调用错误的 GCC。
五、第一个 C 语言程序:Hello World
打开新建文件夹

然后拖动文件夹用vscode打开


然后在文件夹内创建 main.c:





c
#include <stdio.h>
int main()
{
printf("Hello, World!\n");
return 0;
}
六、测试 scanf 输入:避免"程序不能输入"的坑
学习 C 语言经常需要使用 scanf。把 main.c 修改为:
c
#include <stdio.h>
int main()
{
int a, b;
printf("请输入两个整数:");
if (scanf("%d %d", &a, &b) != 2) {
printf("输入格式错误!\n");
return 1;
}
printf("两数之和:%d\n", a + b);
return 0;
}
如果出现乱码:

在 VS Code 下方的终端中输入:
chcp 65001
执行成功会显示类似:
Active code page: 65001
正常情况下应该显示:
请输入两个整数:10 20
两数之和:30
九、总结
配置 C 语言开发环境,可以记住这条主线:
安装 VS Code → 安装 C/C++ 扩展 → 安装 GCC/GDB → 配置 Path → 编译运行 → F5 调试。
对于初学者,建议先掌握这两条命令:
powershell
gcc main.c -o main.exe
.\main.exe
这样不仅能写出第一个 Hello World,也能理解 C 语言"编写源代码---编译---运行"的基本流程。等基础操作熟悉后,再使用 F5 断点调试,会更容易理解程序的执行过程。
参考资料
- VS Code 官方 GCC/MinGW 教程:https://code.visualstudio.com/docs/cpp/config-mingw
- MSYS2 官方安装指南:https://www.msys2.org/
- VS Code 官方 C/C++ 配置文档:https://code.visualstudio.com/docs/cpp/configure-intellisense