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

注意：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 开始调试时，内部逻辑是这样的：

1. launch.json 捕获到调试请求。
2. 检测到 preLaunchTask 字段，暂停启动，先去执行 tasks.json 中对应的编译任务。
3. 编译成功后，launch.json 继续执行，启动指定的 .exe 程序。
4. 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++ 开发调试环境就搭建好了。后续只需根据项目需求调整路径即可。