VS Code 配置 C/C++ 开发与调试环境

在 Windows 环境下使用 Visual Studio Code 进行 C/C++ 开发，配合 MinGW 编译器是一个非常高效的选择。不过，初次配置时往往需要手动调整几个核心文件才能跑通编译和调试流程。下面我将结合实战经验，带你一步步梳理整个配置过程。

1. 插件安装与前置准备

首先，打开 VS Code 的扩展面板（Ctrl+Shift+X），搜索并安装以下两个插件：

C/C++
C/C++ Extension Pack

其中 Extension Pack 通常包含了主题、CMake 及 CMake Tools 等辅助组件。如果未自动包含，请手动补全。

关键前提：确保系统已安装 MinGW64 并正确配置了环境变量。你需要确认命令行中能直接调用 g++ 和 gdb 命令。

2. 工程目录结构

建议新建一个纯英文路径的项目文件夹，例如 D:\C++Codes\demo_test。在该目录下创建一个名为 .vscode 的隐藏文件夹，后续的三个配置文件将全部放在这里。

项目目录结构示意

3. 核心配置文件详解

VS Code 通过三个 JSON 文件来管理构建、调试和代码提示。我们依次来看。

3.1 c_cpp_properties.json：智能感知

这个文件决定了 IDE 的代码补全和跳转能力。它告诉编辑器你的编译器在哪里，头文件在哪。

{
    "configurations": [
        {
            "name": "Win32",
            "includePath": ["${workspaceFolder}/**"],
            "defines": ["_DEBUG", "UNICODE", "_UNICODE"],
            "windowsSdkVersion": "10.0.17763.0",
            "compilerPath": "D:\\ProgramData\\mingw64\\bin\\g++.exe",
            "cStandard": "c11",
            "cppStandard": "c++17",
            "intelliSenseMode": "${default}"
        }
    ],
    "version": 4
}

注意：compilerPath 必须指向你本地实际安装的 g++.exe 路径。Windows 下路径中的反斜杠需要转义为双反斜杠 \\。

3.2 tasks.json：构建任务

这是负责'干活'的文件，定义了如何调用编译器生成可执行文件。

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "shell",
            "label": "task g++",
            "command": "D:\\ProgramData\\mingw64\\bin\\g++.exe",
            "args": [
                "-g",
                "${file}",
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe",
                "-I",
                "D:\\C++Codes\\C++Study",
                "-std=c++17"
            ],
            "options": {
                "cwd": "D:\\ProgramData\\mingw64\\bin"
            },
            "problemMatcher": ["$gcc"],
            "group": "build"
        }
    ]
}

关键字段说明：

label: 任务的名称，后续调试配置会引用这个名字。
command: 编译器的绝对路径。
args: 编译参数。-g 用于生成调试信息，-std=c++17 指定语言标准。
cwd: 工作目录，建议设为编译器所在目录或项目根目录。

3.3 launch.json：调试配置

这个文件控制程序如何启动以及如何附加调试器。

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "g++.exe 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:\\ProgramData\\mingw64\\bin\\gdb.exe",
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "task g++"
        }
    ]
}

关键点：

program: 生成的 exe 路径，需与 tasks.json 的输出一致。
externalConsole: 设为 true 会在外部 CMD 窗口运行程序，方便查看输出。
preLaunchTask: 这里填写的任务名必须与 tasks.json 中的 label 完全一致，这样按下 F5 前会自动先编译。
miDebuggerPath: 指向 gdb.exe 的路径。

4. 工作流程串联

当你按下 F5 开始调试时，内部逻辑是这样的：

launch.json 捕获到调试请求。
检测到 preLaunchTask 字段，暂停启动，先去执行 tasks.json 中对应的编译任务。
编译成功后，launch.json 继续执行，启动指定的 .exe 程序。
GDB 调试器附加到进程上，进入断点调试模式。

这种机制确保了每次调试的都是最新编译的版本，避免了手动编译的繁琐。

5. 验证环境

在项目根目录下新建 hello_world.cpp，写入以下代码：

#include <iostream>
using namespace std;

int main() {
    cout << "Hello World From Visual Studio Code." << endl;
    system("pause");
    return 0;
}

按 F5 运行。如果弹出一个黑色控制台窗口并显示 Hello World，且没有闪退，说明配置成功。

小贴士：如果黑窗口一闪而过，记得在 return 0; 之前加上 system("pause");，或者在 launch.json 中将 externalConsole 保持为 true。

至此，一套完整的 VS Code C/C++ 开发调试环境就搭建好了。后续只需根据项目需求调整路径即可。