Debian上如何调试Rust程序

在 Debian 上调试 Rust 程序

调试 Rust 程序，尤其是跑到 Debian 这种生产级系统上时，环境准备是关键的第一步。先说说几个核心判断：Rust 的调试体验，虽然不如 C++ 那般“祖师爷级”成熟，但好在工具链配合得当，一样能玩得转。

一 环境准备

先把 Rust 工具链装上再说。如果还没装，一步到位的事：

• curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
• 装完后记得刷新一下环境：source $HOME/.cargo/env

调试器呢？GDB 和 LLDB，两员老将，Debian 上都有现成的包：sudo apt update && sudo apt install gdb lldb。然后别忘了补上 Rust 的调试增强组件：rustup component add rust-src llvm-tools-preview。

这里有个小知识：Rust 用的是 DWARF 调试信息格式，所以 GDB 和 LLDB 都能直接上手。不过 rust-gdb 和 rust-lldb 这两个封装版本，对 Rust 语法支持更友好，建议直接用。

二 构建与符号

调试信息从哪来？当然是构建时保留的。

• 默认的 cargo build 就是 debug 模式，生成在 target/debug/ 下，符号信息完整，堆栈也很清楚。
• 但如果你追求 release 模式下的性能，又想在出问题时能追查，可以在 Cargo.toml 的 [profile.release] 里加上 debug = true，再 cargo build --release，这样既快又能保留调试信息。
• 这一点值得注意：cargo install 默认走 release 构建，如果想调试某个安装的 crate，得用 cargo install --debug 。

三 使用 GDB 调试

启动方式很简单：rust-gdb target/debug/your_binary。然后就能进入熟悉的 GDB 世界了。

• 断点：break main 或更精确的 break your_crate::your_function。
• 运行：run，想带参数？直接 run arg1 arg2。
• 单步：step 进函数，next 跳过。
• 继续：continue。
• 打印：print variable，表达式也行。
• 调用栈：backtrace，简写 bt。
• 条件断点：比如 break your_function if variable == 42，这才是真正的高阶玩法。

小建议：开启 GDB 的 Rust 美化打印，比如在 VS Code 配置里加上 -enable-pretty-printing，可读性会好很多。

四 使用 LLDB 调试

启动：rust-lldb target/debug/your_binary。LLDB 的命令行风格跟 GDB 略有不同，但核心逻辑差不多。

• 断点：b binary_search，或者更精确的 breakpoint set -f main.rs -l 42。
• 运行：r，参数预设用 settings set target.run-args "arg1 arg2"。
• 单步：thread step-in（进入函数），thread step-over（跳过）。
• 继续：continue。
• 变量：frame variable 查看当前帧。
• 表达式求值：expr size == 24。
• 监视点：watch set var base。
• 组合技巧：条件断点加自动打印堆栈——breakpoint set -c "half == 3" -f main.rs -l 13 -C bt，能省不少事。

同样，rust-lldb 对 Rust 类型和名称做了优化，别嫌慢，值得用。

五 进阶与 IDE 集成

到了这步，基本调试已经够了。但有些问题，比如 I/O 瓶颈、内存泄漏、系统调用异常，光靠断点是不够的。

• 系统调用跟踪：strace -p ，或者指定跟踪类型，比如 strace -e trace=open,read,write -p 。库函数跟踪用 ltrace -p 。
• 内存错误检测：sudo apt install valgrind，然后 valgrind --tool=memcheck target/debug/your_binary。Valgrind 对 Rust 的 Vec/String 等容器支持不错，放心用。
• 日志与快速迭代：最朴素的 println! 和 dbg!（dbg!(x) 会输出文件名、行号、值，极其方便）。如果追求结构化，log + env_logger 组合，运行时 RUST_LOG=info cargo run 即可。还有 cargo-watch，cargo install cargo-watch 后 cargo watch -x run，改完代码自动构建运行，边改边测。
• VS Code 调试配置：先装 rust-analyzer 扩展，然后在 .vscode/launch.json 里配置 GDB。关键参数：type: cppdbg、request: launch、program: "${workspaceFolder}/target/debug/your_binary"、MIMode: gdb、miDebuggerPath: "/usr/bin/gdb"，别忘了在 setupCommands 里加入 -enable-pretty-printing。.vscode/tasks.json 里加个构建任务：label: "cargo build"，command: "cargo build"，group: { kind: "build", isDefault: true }。
• 打包与调试符号：如果用的是 cargo deb，默认会剥离符号。需要调试的话，用 cargo deb --separate-debug-symbols 把符号分离打包，后面 GDB/LLDB 就能加载了。这条对 Debian 包维护者特别实用。

总的来说，Debian 下调试 Rust 并不复杂，关键是把环境基础打牢，工具选对，然后习惯这些命令行或 IDE 的操作方式。调试多了，自然就顺手了。