CodeLLDB 调试器使用完全指南

荣铖澜Ward

于 2025-06-19 09:25:49 发布

阅读量336

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00381/article/details/148758220

CodeLLDB 调试器使用完全指南

codelldb A native debugger extension for VSCode based on LLDB 项目地址: https://gitcode.com/gh_mirrors/co/codelldb

前言

CodeLLDB 是一个强大的 LLDB 调试器扩展，专为 Visual Studio Code 设计。它提供了丰富的调试功能，支持多种编程语言，包括 C、C++、Rust 等。本文将详细介绍 CodeLLDB 的核心功能和使用方法，帮助开发者充分利用这个工具进行高效的代码调试。

基础调试配置

启动新调试会话

要开始调试，首先需要创建一个启动配置。以下是一个最基本的配置示例：

{
    "name": "启动调试",
    "type": "lldb",
    "request": "launch",
    "program": "${workspaceFolder}/<可执行文件>",
    "args": ["-参数1", "-参数2"]
}

关键配置属性说明：

name: 配置名称，显示在运行和调试面板中
type: 必须设置为 "lldb"
request: 调试启动方式，可以是 "launch"（启动新进程）或 "attach"（附加到现有进程）
program: 可执行文件路径

启动新进程

当选择 "launch" 方式时，可用的额外配置属性：

| 属性 | 类型 | 说明 | |------|------|------| | program | 字符串 | 可执行文件路径（必需） | | args | 字符串/数组 | 命令行参数 | | cwd | 字符串 | 工作目录 | | env | 对象 | 环境变量 | | stdio | 多种 | 标准输入/输出重定向 | | terminal | 字符串 | 终端类型（console/integrated/external） |

附加到现有进程

当选择 "attach" 方式时，可用的额外配置属性：

| 属性 | 类型 | 说明 | |------|------|------| | program | 字符串 | 可执行文件路径（可选） | | pid | 数字 | 要附加的进程ID | | waitFor | 布尔值 | 等待进程启动 |

高级调试功能

标准输入/输出重定向

通过 stdio 属性可以灵活控制调试程序的输入输出：

"stdio": [null, "log.txt", null]  // stdin和stderr使用默认终端，stdout输出到文件

远程调试

CodeLLDB 支持通过 LLDB 服务器进行远程调试：

在远程机器上运行 lldb-server platform --server --listen *:<端口>
创建包含以下命令的配置：

"initCommands": [
    "platform select remote-linux",
    "platform connect connect://<远程主机>:<端口>"
]

反向调试（实验性）

启用反向调试可以回溯程序执行历史：

"reverseDebugging": true

调试外部启动的程序

可以通过特殊格式的 URI 从外部启动调试会话：

code --open-url "vscode://vadimcn.vscode-lldb/launch/command?/path/可执行文件 参数1 参数2"

RPC 服务器

对于更复杂的外部调试场景，可以配置 RPC 服务器：

"lldb.rpcServer": {
    "host": "127.0.0.1",
    "port": 12345,
    "token": "密钥"
}

然后通过客户端连接发送调试配置。

实用技巧

调试 Rust 单元测试

在项目根目录创建 .cargo/config 文件：

[target.<当前目标三元组>]
runner = ".cargo/codelldb.sh"

创建 .cargo/codelldb.sh 脚本：

#!/bin/bash
code --open-url "vscode://vadimcn.vscode-lldb/launch/command?LD_LIBRARY_PATH=$LD_LIBRARY_PATH&$*"

正常执行测试即可自动启动调试

调试构建脚本

在 Rust 项目中，可以这样调试 build.rs：

let url = format!("vscode://vadimcn.vscode-lldb/launch/config?{{'request':'attach','pid':{}}}", std::process::id());
std::process::Command::new("code").arg("--open-url").arg(url).output().unwrap();
std::thread::sleep_ms(1000); // 等待调试器附加