VS Code 配置 C/C++ 开发环境完整指南

注意：MSYS2 需要 64 位 Windows 8.1 及以上版本。

安装过程中保持默认设置，直到出现终端窗口。在终端中输入以下命令并回车，安装必要的编译工具链：

pacman -S--needed base-devel mingw-w64-ucrt-x86_64-toolchain

系统会提示是否继续安装，输入 y 并回车确认。等待进度条走完，关闭终端。

2. 配置系统环境变量

找到 MSYS2 安装目录下的 ucrt64\bin 文件夹（默认路径通常为 C:\msys64\ucrt64\bin），复制该路径。

打开 Windows 搜索框，输入 "编辑系统环境变量" 并进入设置界面。

1. 点击 "环境变量" 按钮。
2. 在 "用户变量" 中找到 Path，双击打开。
3. 点击 "新建"，粘贴刚才复制的路径。
4. 逐层点击 "确定" 保存退出。

3. 验证安装

按下 Win + R，输入 cmd 打开命令行，依次执行以下命令检查版本：

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

若显示版本号信息，说明编译器与调试器已正确配置。

四、配置 VS Code 的 C/C++ 编程环境

1. 安装扩展插件

启动 VS Code，按下 Ctrl + Shift + x 进入扩展面板。

1. 搜索 C/C++，安装 Microsoft 官方提供的扩展包。
2. （可选）搜索 Chinese 安装汉化插件，重启后即可使用中文界面。

提示：C/C++ Extension Pack 包含更多项目构建工具，可根据需求选择性安装。

五、测试 VS Code 的 C/C++ 编程环境

1. 创建代码工程

VS Code 基于文件夹管理项目。新建一个不含中文路径的文件夹（例如 Code），并在其中建立存放代码的子文件夹。

打开 VS Code，点击 "打开文件夹"，选择刚才创建的目录。首次打开可能会提示信任作者，点击 "是，我信任此作者"。

2. 单个 .c 文件的运行和调试

在子文件夹中创建 test.c 文件，写入示例代码：

#include <stdio.h>

int main() {
    for (int i = 0; i < 5; i++) {
        printf("Hello World~%d\n", i);
    }
    return 0;
}

点击右上角的运行按钮，选择之前安装的 GCC 编译工具。若弹出权限提示，点击 "是" 即可。

断点调试

在行号左侧空白处点击可添加断点。再次运行程序，下方将显示调试面板，包含以下常用功能：

• 继续：执行至下一个断点或结束。
• 单步跳过：执行当前行，不进入函数内部。
• 单步进入：进入函数内部逐行执行。
• 单步跳出：执行完当前函数剩余部分并返回。

3. 多个 .c 文件的运行与调试

多文件项目需要修改 VS Code 的任务配置文件。

首次运行后，项目根目录下会自动生成 .vscode 文件夹，包含 tasks.json。双击打开该文件，修改编译规则以支持多文件：

1. 将 ${file} 注释掉，改为 "*.c"，表示编译当前目录下所有 C 文件。
2. 将输出文件名统一指定为 program.exe。

{
    "version": "0.2.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: gcc.exe build active file",
            "command": "gcc",
            "args": [
                "-g",
                "${workspaceFolder}/*.c",
                "-o",
                "${workspaceFolder}/program.exe"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [ "$gcc" ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "任务详情"
        }
    ]
}

接着配置调试器。点击左侧 "运行与调试"，选择 "创建 launch.json 文件"，选择 C++ (GDB/LLDB)。

在生成的 JSON 文件中，修改 miDebuggerPath 指向 MinGW 中的 gdb 路径（注意反斜杠转义），并确保 program 字段指向编译后的 program.exe。

注意：Windows 路径中的反斜杠 在 JSON 中需转义为 \\。

完成配置后，即可在多文件项目中正常进行断点调试。例如创建一个包含头文件和源文件的项目，设置断点后观察调用栈变化，理解函数间的执行流程。

参考资料

• Running Visual Studio Code on Windows
• C++ programming with Visual Studio Code
• Get Started with C++ and MinGW-w64 in Visual Studio Code