1. 环境准备
确保您的系统已安装必要的编译工具链、调试器和 VSCode 插件。
| 组件类别 | 具体项目 | 安装/配置说明 |
|---|---|---|
| 系统工具 | 编译工具链 (build-essential) | 终端执行：sudo apt update && sudo apt install build-essential gdb cmake |
| 调试器 (GDB) | 通常已包含在 build-essential 中，也可单独安装 | |
| VSCode 插件 | C/C++ (Microsoft) | 提供代码智能感知、调试支持 |
| CMake 与 CMake Tools | 增强对 CMake 项目的支持（非必需但推荐） |
2. 项目配置（CMakeLists.txt）
在项目的 CMakeLists.txt 中，必须设置 Debug 构建类型以生成包含调试信息的可执行文件。这是能够进行断点调试的基础
cmake_minimum_required(VERSION 3.10) project(MyProject)
# 关键配置：设置为 Debug 模式
set(CMAKE_BUILD_TYPE Debug)
# 生成调试符号
# 可选：进一步指定编译标志
set(CMAKE_CXX_FLAGS_DEBUG "$ENV{CXXFLAGS} -O0 -Wall -g -ggdb")
# -O0 优化级别便于调试，-g 生成调试信息
add_executable(${PROJECT_NAME} main.cpp)
使用标准的 CMake 流程构建项目：
mkdir -p build
cd build
cmake ..
make -j4
3. 配置 VSCode 调试环境
VSCode 主要通过当前项目根目录下 .vscode 文件夹中的 launch.json 和 tasks.json 文件来控制调试行为。
3.1 创建调试配置文件
- 在 VSCode 中打开项目文件夹。
- 切换到'运行和调试'视图 (
Ctrl+Shift+D)。 - 点击'创建 launch.json 文件'，选择
C++ (GDB/LLDB)。 - 这将自动生成
.vscode/launch.json文件。根据需要，可能还会自动生成或需要手动创建tasks.json文件
3.2 关键配置详解
下面表格列出了 launch.json 和 tasks.json 中最关键的配置项及其作用。
| 配置文件 | 配置项 | 说明与示例 |
|---|---|---|
launch.json | "program" | 【最关键】 指定要调试的可执行文件的绝对路径。例如： |
