Rust 在 Ubuntu 中如何进行调试

调试 Rust 代码，尤其是在 Ubuntu 环境下，其实有不少门道。今天咱们就来聊聊，怎么高效地解决这个问题。

环境准备与构建配置

先说说环境准备。你需要安装 GDB 或 LLDB，直接 sudo apt install gdb lldb 就行。如果习惯用 VS Code，记得装上 rust-analyzer 和 CodeLLDB 这两个扩展。调试的关键在于调试符号，所以确保是用 cargo build 来构建，默认就会生成调试信息。如果想明确控制，在 Cargo.toml 里设置 [profile.dev] debug = true 就好。另外，rust-gdb 和 rust-lldb 这两个包装器对 Rust 类型支持更好，推荐优先使用。

命令行调试：GDB 与 LLDB

用 GDB 来调试：cargo build 之后，直接启动 rust-gdb target/debug/your_program。常用的命令包括：break src/main.rs:10 设置断点，run 启动运行，next 和 step 控制单步执行，print x 查看变量，backtrace 查看调用栈。现代 GDB（≥ 8.0）对 Rust 语法支持已经不错了。

用 LLDB 也很类似：启动 rust-lldb target/debug/your_program，常用命令有 breakpoint set --name main 设置断点，run 运行，next/step 单步，frame variable my_var 查看变量。特别提一下，LLDB 对 Option、Result、Box 这些 Rust 类型显示更友好，检查起来更顺手。

IDE 图形化调试：VS Code

说到图形化调试，VS Code 是首选。安装 rust-analyzer 和 CodeLLDB 扩展后，在项目根目录创建 .vscode/launch.json，配置一个简单的调试任务。具体配置示例：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "lldb",
            "request": "launch",
            "name": "Debug",
            "program": "${workspaceFolder}/target/debug/your_program",
            "args": [],
            "cwd": "${workspaceFolder}"
        }
    ]
}

然后，在代码行号左侧点击设置断点，按 F5 启动调试，就能在侧边栏查看变量、调用栈并控制执行，非常直观。

快速定位与辅助工具

快速定位问题也很重要。程序崩溃时，设置环境变量 RUST_BACKTRACE=1 然后运行，就能看到调用栈。日常开发中，用 dbg! 宏可以快速打印值和位置，或者用 log 和 env_logger 输出结构化日志，比如 RUST_LOG=info cargo run。

内存和性能方面，valgrind --tool=memcheck 能检测内存错误和泄漏，perf 工具可以记录性能数据。如果想生成火焰图，用 cargo install flamegraph 后执行 flamegraph ./target/release/your_program 就行。

常见问题与排查

最后说说常见问题。如果调试时发现没有调试符号或源码对不上，先确认是用 cargo build 而不是 --release，再检查 Cargo.toml 里 [profile.dev] debug = true 是否设置，必要时 cargo clean 再重新构建。

第三方库或系统依赖缺失导致构建或运行异常，通常安装常用依赖 sudo apt-get install build-essential libssl-dev pkg-config 就能解决，根据报错安装对应的 -dev 包，更新工具链 rustup update 后重试。