Debian上Rust代码如何调试与测试

在 Debian 上调试与测试 Rust 的高效流程

一 环境准备

工欲善其事，必先利其器。想在 Debian 上顺畅地调试 Rust 代码，第一步自然是把工具链配置妥当。

• 安装 Rust 工具链：打开终端，执行这条经典命令即可：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh。安装完成后，别忘了运行 source $HOME/.cargo/env 让环境变量立即生效。为了获得更丝滑的调试体验，建议额外安装 Rust 的调试组件：rustup component add rust-src llvm-tools-preview。最后，在 Debian 上安装系统级的调试器：sudo apt update && sudo apt install gdb lldb。这套组合拳下来，你的调试器就能友好地显示 Rust 特有的堆栈信息、变量和类型了。

二 调试方法与常用工具

环境就绪，接下来看看有哪些趁手的调试“兵器”。

• 构建配置
  • 调试构建：直接使用 cargo build（默认就包含了调试信息），这是设置断点和检查变量的基础。
  • 发布构建保留调试信息：有时候线上出了问题也需要调试。这时可以在 Cargo.toml 文件的 [profile.release] 部分加上 debug = true。这样，即使使用 cargo build --release 构建发布版本，也会保留调试符号，为事后定位问题留了一扇窗。
• 使用 rust-gdb / rust-lldb
  • 启动调试：rust-gdb target/debug/your_project 或 rust-lldb target/debug/your_project，任选其一。
  • 常用命令：break main 或 break your_crate::func 设置断点；step/next 用于单步进入或跳过函数；continue 让程序继续运行；print var 或 frame variable 查看变量值；backtrace（简写 bt）能一览调用栈的全貌。如果想在特定条件下才触发断点，可以试试 break your_function if x == 42。
• 快速打印与日志
  • “打印大法”永远不过时。用 println!("{:?}", x) 输出调试信息，println!("{:#?}", x) 能获得格式更美观的展开显示。而 dbg!(&x) 则更便捷，它能连同文件名和行号一起打印出来。
  • 对于更复杂的项目，结构化的日志更利于管理。使用 log 库搭配 env_logger，运行时通过环境变量控制输出级别，例如 RUST_LOG=info cargo run，就能清晰追踪程序的运行轨迹。
• 系统级跟踪
  • 当问题可能出在系统调用或 I/O 时，strace 是你的好帮手。strace -p 跟踪指定进程，或者用 strace -e trace=open,read,write -p 只关注文件打开、读写等特定调用。
  • 如果想跟踪动态库的函数调用，ltrace -p 可以派上用场。
• 内存与泄漏检查
  • 怀疑有内存问题？valgrind --tool=memcheck target/debug/your_program 可以检测非法内存访问和泄漏。需要注意的是，它对高度优化或内联的代码支持有限，因此最好在调试构建下使用。
• 观测与自动化
  • 想实现“保存即运行”的流畅体验？cargo-watch -x run 可以监听文件变化并自动重新构建运行，极大提升调试迭代的速度。

三 测试流程与常用命令

说完了调试，再来看如何构建稳健的测试防线。

• 单元测试
  • 在 src/lib.rs 或 src/main.rs 中，使用 #[cfg(test)] mod tests { #[test] fn test_name() { ... } } 这样的模式来编写测试函数。
  • 运行所有测试只需 cargo test。如果测试中用了 println! 想看到输出，记得加上 -- --nocapture 参数：cargo test -- --nocapture。
• 集成测试与示例
  • 集成测试通常放在项目根目录的 tests/ 文件夹下，文件以 _test.rs 结尾。运行它们同样使用 cargo test 命令。
  • 项目 examples/ 目录下的示例代码，可以用 cargo run --example 来执行，这对于端到端的场景验证非常方便。
• 断言与测试工具
  • 测试离不开断言，assert!、assert_eq!、assert_ne! 这些是基本功。为了提升测试的覆盖率和可维护性，可以结合像 rstest 这样的测试框架来进行参数化测试和夹具管理。

四 调试与测试的快速示例

理论讲了不少，来看两个具体的例子，感受一下实际的操作流程。

• 调试示例
  1. 代码示例（src/main.rs）

     fn add(a: i32, b: i32) -> i32 {
         a + b
     }
     fn main() {
         let x = 10;
         let y = 20;
         let z = add(x, y);
         dbg!(&z); // 调试输出
     }

  2. 构建与启动调试

     cargo build
     rust-gdb target/debug/your_project

  3. GDB 常用操作

     (gdb) break main
     (gdb) run
     (gdb) next
     (gdb) print x
     (gdb) backtrace

• 测试示例
  1. 单元测试（src/lib.rs）

     pub fn add(a: i32, b: i32) -> i32 {
         a + b
     }
     #[cfg(test)]
     mod tests {
         use super::*;
         #[test]
         fn test_add() {
             assert_eq!(add(1, 2), 3);
             assert_eq!(add(-1, 1), 0);
         }
     }

  2. 运行测试并查看输出

     cargo test -- --nocapture

五 常见问题与排查建议

最后，盘点几个调试测试时容易遇到的“坑”，以及对应的解决思路。

• 断点无法命中或变量不可见：首先确认你是否在使用调试构建（cargo build）进行调试。如果是发布构建，请确保按前文所述开启了 debug = true。实在不行，临时插入 println! 或 dbg! 辅助定位也是常用策略。
• 优化导致单步异常：高度优化的代码可能会打乱执行顺序，使得单步调试变得困难。调试时尽量使用低优化级别。对于发布版本的事后分析，保留调试符号至关重要。
• 无法打印复杂结构：如果想用 {:?} 或 {:#?} 打印一个自定义类型，记得为它派生（#[derive(Debug)]）或手动实现 Debug trait。
• 系统调用/库调用问题：当怀疑问题出在底层调用时，别急着埋头看源码。先用 strace 或 ltrace 观察实际的执行路径和参数，往往能快速缩小范围。
• 内存错误与泄漏：使用 valgrind 在调试构建下进行排查通常很有效。如果问题涉及第三方 C 库，需要确保对应的调试符号（-dbg 包或编译时带 -g 选项）可用，否则输出可能是一堆难以解读的地址。