首先安装MinGW-w64并配置环境变量,确保g++和gdb可用;然后在VSCode中创建tasks.json文件定义编译任务,使用g++ -g生成可执行文件;接着配置launch.json设置调试器cppdbg,指定程序路径和preLaunchTask为编译任务名称;最后通过Ctrl+Shift+B编译并按F5启动调试,实现断点调试与变量查看。

在VSCode中配置C++编译与调试环境,关键在于正确安装编译器、配置任务(task)和调试器(launch),并设置好相关JSON文件。下面以Windows平台使用MinGW-w64为例,介绍完整步骤。
安装编译器与调试工具
要编译和调试C++程序,必须先安装支持的编译器套件:
- 下载并安装 MinGW-w64(推荐使用 MinGW-w64 或通过 MSYS2 安装)
- 将
bin目录(如C:\mingw64\bin)添加到系统 PATH 环境变量中 - 打开终端,运行
g++ --version和gdb --version验证是否安装成功
创建项目并配置tasks.json
用于定义如何编译C++源码。按下 Ctrl+Shift+P,输入“Tasks: Configure Task”,选择“Create tasks.json file from template”,然后选择“Others”。
修改内容如下:
立即学习“C++免费学习笔记(深入)”;
{
"version": "2.0.0",
"tasks": [
{
"type": "shell",
"label": "g++ build",
"command": "g++",
"args": [
"-g",
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}.exe"
],
"options": {
"cwd": "${workspaceFolder}"
},
"problemMatcher": ["$gcc"],
"group": {
"kind": "build",
"isDefault": true
}
}
]
}
此配置表示使用 g++ -g 编译当前文件,并生成同名可执行文件(.exe),便于调试。
配置launch.json进行调试
按下 F5 或点击“运行和调试”侧边栏,选择“C++ (GDB/LLDB)”,会自动生成 launch.json。
确保内容类似以下:
{
"version": "0.2.0",
"configurations": [
{
"name": "Debug C++ File",
"type": "cppdbg",
"request": "launch",
"program": "${fileDirname}/${fileBasenameNoExtension}.exe",
"args": [],
"stopAtEntry": false,
"cwd": "${workspaceFolder}",
"environment": [],
"externalConsole": false,
"MIMode": "gdb",
"miDebuggerPath": "gdb.exe",
"setupCommands": [
{
"description": "Enable pretty printing",
"text": "-enable-pretty-printing",
"ignoreFailures": true
}
],
"preLaunchTask": "g++ build",
"logging": {
"engineLogging": false
}
}
]
}
注意:preLaunchTask 对应的是 tasks.json 中的 label,确保名称一致,这样调试前会自动编译。
开始编译与调试
打开一个 .cpp 文件,按下 Ctrl+Shift+B 可触发构建任务,生成可执行文件。
在代码中设置断点,按 F5 启动调试,程序会在断点处暂停,支持查看变量、调用栈等操作。
基本上就这些。只要编译器路径正确,JSON配置无误,VSCode就能顺利编译和调试C++程序。










