I 前提条件

1.1 彻底卸载 VS Code

参考文档：华为云

1.1.1 删除安装插件

【Win + R】输入：

1

%userprofile%

删除当前路径下的 .vscode 文件夹。

1.1.2 删除用户信息和缓存信息

【Win + R】输入：

1

%appdata%

删除当前路径下的 Code 和 Visual Studio Code 文件夹。

📢 找不到 AppData 文件夹？

  1. 文件夹中点击 “查看” 勾选 “显示隐藏文件和文件夹” 即可找到。
  2. 或者 ( Win + S ) 搜索文件夹资源管理器选项，勾选 “显示隐藏文件” 即可。

1.2 安装 VS Code

官方下载：Visual Studio Code

1.3 安装 VS Code 扩展

  1. 打开 VS Code 扩展「 Ctrl + Shift + X 」或在侧边栏上选择“扩展”视图图标。
  2. 搜索 c/c++ 、code runner 。
  3. 分别安装 。

II 安装 MinGW-x64

2.1 通过 MSYS2 安装 Mingw-w64

  1. 下载安装包：MSYS2 或 GitHub

  2. 运行安装程序。请注意 MSYS2 需要 64 位的 Windows 8.1 或更新版本。

  3. 在向导中，选择所需的安装文件夹。记录下该目录以备日后使用。大多数情况下，建议的目录是可以接受的。这同样适用于设置开始菜单快捷方式的步骤。完成后，确保选中 “立即运行 MSYS2 “复选框，然后选择 “完成”。这将为您打开一个 MSYS2 终端窗口。

  4. 在该终端中，运行以下命令安装 MinGW-w64 工具链：

1

pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain
  1. 按 Enter 键接受 toolchain 组中默认的软件包数量。

PIC_20260909_083010.png

  1. 当系统提示是否继续安装时，输入 Y。

  2. 通过执行以下步骤，将 MinGW-w64 bin 文件夹的路径添加到 Windows PATH 环境变量

    1. 在 Windows 搜索栏中，键入设置以打开 Windows 设置。
    2. 搜索编辑帐户的环境变量。
    3. 在您的用户变量中，选择 Path 变量，然后选择编辑。
    4. 选择新建，然后将您在安装过程中记录的 MinGW-w64 目标文件夹添加到列表中。如果您使用了上面的默认设置，则此路径将为：C:\msys64\ucrt64\bin。
    5. 选择确定，然后在环境变量窗口中再次选择确定以更新 PATH 环境变量。您必须重新打开任何控制台窗口，更新后的 PATH 环境变量才能生效。

2.2 检查 MinGW 安装

要检查你的 Mingw-w64 工具是否正确安装和可用，请打开一个新的命令提示符并输入：

1
2
3

gcc --version
g++ --version
gdb --version

您应该看到输出，其中说明了您已安装的 GCC、g++ 和 GDB 的版本。如果不是这种情况

  1. 确保您的 PATH 变量条目与安装工具链的 MinGW-w64 二进制文件位置匹配。如果编译器在该 PATH 条目中不存在，请确保您已按照之前的说明操作。
  2. 如果 gcc 具有正确的输出但 gdb 没有，则您需要从 MinGW-w64 工具集中安装您缺少的软件包。
    • 如果在编译时收到“miDebuggerPath 的值无效。”消息，则原因之一可能是您缺少 mingw-w64-gdb 软件包

2.3 更新 MSYS2

安装 MSYS2 后，它将通过 pacman 进行自我更新，更多信息请参见更新指南 。要更新所有软件包，请运行以下命令：

1

pacman -Suy

在某些情况下，某些核心软件包会被更新，pacman 会提示你关闭所有终端。 确认之后，你需要启动一个新的终端，再次运行更新（pacman -Suy）来更新剩余的非核心软件包。

III 编写测试代码

3.1 建立一个标准 C 项目

为了养成良好的编程习惯，建议不要直接把 .c 文件扔到桌面。

例如建立：

1

E:\Code\C\01-hello\

打开 VS Code ，从菜单栏中找到：文件 > 打开文件夹，导入上面刚创建的 01-hello 项目，并在随后的提示中选择“信任”。

在打开的 01-hello 项目中创建 main.c ，内容如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

#include <stdio.h>

int main(void)
{
    int a = 10;
    int b = 20;
    int result = a + b;

    printf("result = %d\n", result);

    return 0;
}

3.2 创建 .vscode 文件夹

在项目目录创建：

1

.vscode

然后在 .vscode 中创建：

1
2
3

tasks.json
launch.json
settings.json

文件说明：

  • tasks.json 用来告诉 VS Code 如何使用 GCC 编译 C 程序。
  • launch.json 这个文件负责 F5 → GCC 编译 → GDB 调试。
  • settings.json 指定编译器目录及使用版本。

最终目录结构：

1
2
3
4
5
6

01-hello
├── main.c
└── .vscode
    ├── launch.json
    ├── settings.json
    └── tasks.json

3.3 配置 tasks.json

写入以下内容：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C: gcc build",
            "command": "gcc",
            "args": [
                "-Wall",
                "-Wextra",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "使用 GCC 编译当前 C 文件"
        }
    ]
}

参数说明：

  • -Wall 开启常见警告。
  • -Wextra 开启更多警告。
  • -g 生成 GDB 调试信息。

3.4 配置 launch.json

写入以下内容：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "C: Debug",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}\\${fileBasenameNoExtension}.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "C:\\msys64\\ucrt64\\bin\\gdb.exe",
            "preLaunchTask": "C: gcc build",
            "setupCommands": [
                {
                    "description": "启用 GDB 美化输出",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

注意以下这一行，必须与你实际安装位置一致。

1

"miDebuggerPath": "C:\\msys64\\ucrt64\\bin\\gdb.exe"

3.5 配置 settings.json

建议加入：

1
2
3
4
5
6

{
    "C_Cpp.default.compilerPath": "C:\\msys64\\ucrt64\\bin\\gcc.exe",
    "C_Cpp.default.intelliSenseMode": "windows-gcc-x64",
    "C_Cpp.default.cStandard": "c17",
    "C_Cpp.errorSquiggles": "enabled"
}

这里指定：

  • C 标准：C17
  • 编译器：GCC

IV 运行或调试代码

4.1 运行代码

有以下方法运行代码：

a. 快捷键「 Ctrl + F5 」直接执行。

b. 在代码页面右上角使用 Code Runner 扩展执行代码（快捷键「 Ctrl + Alt + N 」）。

c. 使用 VS Code Terminal （快捷键「 Ctrl + ` 」）在命令行中手动执行：

1
2

gcc main.c -o main.exe
.\main.exe

终端应该看到：

1

result = 30

4.2 调试代码

在：

1

int result = a + b;

这一行左边行号前点击一下，设置一个断点。会在这行代码行号前出现一个红点：

1

● int result = a + b;

然后按 F5 程序会停在断点。

此时 VS Code 左侧可以看到：

1
2
3
4
5

VARIABLES

a       10
b       20
result  ...

4.3 单步调试

快捷键功能
F5继续执行
F10单步跳过
F11单步进入函数
Shift + F11跳出函数
Shift + F5停止调试

比如：

1
2
3

int a = 10;
int b = 20;
int result = a + b;

你可以按 F10 一行一行执行。

V. 参考文档

官方文档：C/C++ for Visual Studio Code