Ubuntu 下高效调试 Rust 的实用技巧
一 基础准备与环境
- 安装调试器与 Rust 增强工具：sudo apt update && sudo apt install -y gdb lldb；通过 rustup 安装 rust-gdb/rust-lldb 与源码组件（便于源码级调试）：执行 rustup component add rust-src llvm-tools-preview。调试信息默认随 dev 配置开启；若使用 release 构建，可显式开启调试信息：cargo build -g 或在 Cargo.toml 中设置 [profile.release] debug = true。为获得崩溃时的调用栈，设置环境变量：RUST_BACKTRACE=1 cargo run（或 RUST_BACKTRACE=full 获取更详尽信息）。
二 命令行调试 GDB LLDB 与 Rust 专用增强
- 使用 rust-gdb：cargo build && rust-gdb target/debug/your_app；常用命令：break main / break file.rs:line，run，next/step，print var，continue，backtrace/bt，frame n，info locals。Rust 的枚举、闭包在 GDB 中类型名可能较复杂，可结合源码与打印表达式定位。
- 使用 rust-lldb：cargo build && rust-lldb target/debug/your_app；常用命令：breakpoint set --file main.rs --line 10，run，next/step，frame variable，bt。LLDB 对 Rust 的显示与表达式求值体验通常更友好。
- 小技巧：在断点处用 print/expr 直接求值复杂表达式；遇到第三方依赖或标准库代码时，确保已安装 rust-src 以便源码级查看；多线程程序可用 info threads、thread N 切换并 bt 查看各线程回溯。
三 IDE 图形化调试 VSCode 与 JetBrains 系列
- VSCode：安装扩展 rust-analyzer 与 CodeLLDB；使用 Rust 插件生成或检查 .vscode 中的调试配置（launch.json 使用 type: lldb，program 指向可执行文件，如 ${workspaceFolder}/target/debug/your_app），即可断点、变量观察、单步执行。
- CLion / IntelliJ IDEA：通过 JetBrains Rust 插件 直接对 Cargo 项目进行构建与调试，断点、变量、调用栈与测试集成完善，适合大型项目与团队协作。
四 内存与性能问题定位工具
- Valgrind（memcheck）：检测非法内存访问、越界读写与内存泄漏。用法：sudo apt install -y valgrind；valgrind --tool=memcheck target/debug/your_app。注意：Valgrind 不支持 musl 目标，且会带来显著性能开销，优先用于 x86_64-unknown-gnu 的调试构建。
- cargo test：先以单元测试隔离问题，快速回归；配合调试器对失败用例进行断点调试，定位逻辑错误更高效。
- 条件编译与日志：用 #[cfg(debug_assertions)] 包裹仅调试用的代码；在不改业务代码的前提下，结合日志或 dbg! 输出关键路径信息，便于问题复现与排查。
五 进阶与替代调试器
- BugStalker：面向 Linux x86_64 的 Rust 专用调试器，支持源码/汇编查看、变量检查等。安装：sudo apt install -y pkg-config libunwind-dev；cargo install bugstalker；使用：bs target/debug/your_app。适合希望获得更“Rust 风格”体验的开发者。
