首先安装C++编译器、CMake、LLDB及VSCode扩展(C/C++、CMake Tools、CodeLLDB),然后创建含CMakeLists.txt的项目结构,使用CMake Tools选择编译套件并构建生成可执行文件,接着配置.launch.json指定LLDB调试器和程序路径,最后设置断点并启动调试,确保构建成功且路径正确。

在 Visual Studio Code 中进行 C++ 开发,结合 CMake 管理项目并使用 LLDB 进行调试,是一种高效且跨平台的开发方式。下面将一步步说明如何配置 VSCode 以支持基于 CMake 的 C++ 项目,并启用 LLDB 调试功能。
安装必要的工具与扩展
要顺利配置 CMake 与 LLDB,先确保系统中已安装以下组件:
- C++ 编译器:推荐使用 Clang 或 GCC(Linux/macOS),MSVC 或 MinGW(Windows)
- CMake:用于项目构建管理
- LLDB:调试器(macOS 和 Linux 推荐,Windows 可选)
-
VSCode 扩展:
- C/C++(由 Microsoft 提供)
- CMake Tools
- CodeLLDB(强烈推荐,提供 LLDB 调试支持)
在 VSCode 扩展市场中搜索并安装上述插件,尤其是 CodeLLDB,它能正确集成 LLDB 到调试流程中。
配置 CMake 项目结构
一个标准的 CMake 项目通常包含如下文件结构:
立即学习“C++免费学习笔记(深入)”;
/my_project ├── CMakeLists.txt ├── main.cpp └── build/
示例 CMakeLists.txt 内容:
cmake_minimum_required(VERSION 3.14) project(MyApp) set(CMAKE_CXX_STANDARD 17) set(CMAKE_BUILD_TYPE Debug) add_executable(myapp main.cpp)
使用 CMake Tools 插件自动检测 CMakeLists.txt。点击右下角状态栏的“Debug”或“Change Kit”,选择合适的编译器套件(如 Clang 14 或 GCC)。
然后点击“Build”按钮(或按 Ctrl+Shift+P → “CMake: Build”)生成可执行文件,默认输出到 build/ 目录。
配置 LLDB 调试环境
调试需要创建 .vscode/launch.json 文件,指定调试器行为。
按下 Ctrl+Shift+P,输入 “Debug: Add Configuration”,选择 “C++ (LLDB)” 模板,然后编辑 launch.json:
{
"version": "0.2.0",
"configurations": [
{
"name": "Debug with LLDB",
"type": "lldb",
"request": "launch",
"program": "${workspaceFolder}/build/myapp",
"args": [],
"stopOnEntry": false,
"cwd": "${workspaceFolder}",
"environment": [],
"externalConsole": false
}
]
}
关键点说明:
- program:指向 CMake 构建生成的可执行文件路径,根据实际修改
- type: lldb:由 CodeLLDB 扩展提供支持
- stopOnEntry:设为 true 可在主函数第一行暂停
确保构建后的可执行文件存在,否则调试会失败。
启动调试与断点设置
在代码中点击行号左侧设置断点,绿色圆点表示已激活。
点击侧边栏“Run and Debug”图标,选择“Debug with LLDB”配置,然后点击运行按钮。
调试过程中可查看变量值、调用栈、表达式求值等。支持步进(Step Over/Into)、继续运行和暂停。
若遇到“executable not found”错误,请检查 CMake 是否成功构建,以及 launch.json 中的 program 路径是否正确。
基本上就这些。配置一次后,后续项目可复用类似结构,提升开发效率。










