如何在 VS Code 中调试 C++ 程序？-平芜编程栈

VS Code 调试 C++ 的核心是配置launch.json（调试配置）和tasks.json（编译配置），结合官方 C/C++ 插件实现断点、单步执行、变量监控等功能。下面是完整且易懂的调试步骤：

一、前提条件（已完成可跳过）

已安装MinGW-w64（Windows）/GCC（Linux/Mac）编译器，并配置好环境变量（验证：终端输入g++ --version能显示版本）。
VS Code 已安装C/C++ (Microsoft 官方)插件。

二、调试完整步骤（以 Windows 为例）

步骤 1：准备调试用的 C++ 代码

新建debug_demo.cpp，写入带逻辑的测试代码（方便看到调试效果）：

cpp

运行

#include <iostream> #include <vector> using namespace std; int main() { int a = 10; int b = 20; int sum = a + b; vector<int> nums = {1, 2, 3, 4}; for (int num : nums) { cout << "数字：" << num << endl; // 这里打个断点 } cout << "a + b = " << sum << endl; return 0; }

步骤 2：生成编译配置（tasks.json）

编译是调试的前提，VS Code 需要知道如何编译你的代码：

按Ctrl+Shift+B（或点击「终端→运行生成任务」）。
选择「创建 tasks.json 文件」→ 选择「g++.exe - 生成活动文件」。
自动生成tasks.json（存放在.vscode文件夹），无需修改，核心作用是告诉 VS Code 用g++编译当前文件，并生成带调试信息的可执行文件。

步骤 3：生成调试配置（launch.json）

这是调试的核心配置，告诉 VS Code 用什么调试器、调试哪个文件：

点击左侧「运行和调试」图标（或按Ctrl+Shift+D）。
点击「创建 launch.json 文件」→ 选择「C++ (GDB/LLDB)」→ 选择「g++.exe - 生成活动文件」。

自动生成launch.json，关键配置说明：

json

{ "version": "0.2.0", "configurations": [ { "name": "g++.exe - 生成和调试活动文件", "type": "cppvsdbg", // Windows调试器，Linux/Mac为"cppvsdbg"改为"lldb" "request": "launch", "program": "${fileDirname}\\${fileBasenameNoExtension}.exe", // 要调试的可执行文件路径 "args": [], // 程序运行参数（无则空） "stopAtEntry": false, // 是否在程序入口（main函数）自动暂停 "cwd": "${fileDirname}", // 工作目录 "environment": [], "externalConsole": false, // 是否弹出外部终端（建议false，用VS Code内置终端） "MIMode": "gdb", "miDebuggerPath": "gdb.exe", // 调试器路径（MinGW已配环境变量则无需改） "preLaunchTask": "C/C++: g++.exe 生成活动文件", // 调试前先执行的编译任务（必须和tasks.json里的任务名一致） "setupCommands": [ { "description": "为 gdb 启用整齐打印", "text": "-enable-pretty-printing", "ignoreFailures": true } ] } ] }

步骤 4：开始调试（核心操作）

打断点：在代码行号左侧点击，出现红色小圆点（比如在cout << "数字：" << num << endl;这行打断点）。
启动调试：按F5（或点击「运行和调试」面板的绿色三角按钮）。
调试控制（顶部调试工具栏）：
- ▶️ 继续（F5）：从当前断点继续运行到下一个断点。
- ⏭️ 单步跳过（F10）：执行当前行，不进入函数内部（适合循环 / 简单代码）。
- ⏬ 单步进入（F11）：进入当前行调用的函数内部（比如调用自定义函数时用）。
- ⏫ 单步退出（Shift+F11）：从当前函数退出到调用处。
- ⏹️ 停止调试（Shift+F5）：结束调试。
监控变量：
- 左侧「变量」面板：自动显示当前作用域的变量值（如a=10、b=20、num随循环变化）。
- 「监视」面板：手动输入变量名（如sum），实时监控其值。
- 「调用堆栈」面板：查看函数调用层级（main 函数是顶层）。

步骤 5：调试结束

调试完成后，按Shift+F5停止，或点击调试工具栏的停止按钮即可。

三、常见问题解决

调试提示 “找不到任务”：检查launch.json中preLaunchTask的值，必须和tasks.json里的label完全一致（包括空格）。
断点灰色（未命中）：确保编译时生成了调试信息（tasks.json中g++命令默认带-g参数，无需手动加），且代码已保存、重新编译。
变量显示乱码：在launch.json中添加"environment": [{"name": "LC_ALL", "value": "zh_CN.UTF-8"}]（Windows）。