Rust在Debian上如何进行调试

在 Debian 上调试 Rust 的实用指南

一 环境准备

工欲善其事，必先利其器。想在 Debian 上顺畅地调试 Rust 程序，第一步自然是把趁手的工具备齐。

• 安装调试器与语言支持：
  • 安装 GDB/LLDB： 打开终端，运行 sudo apt update && sudo apt install -y gdb lldb 即可。这两个是调试的基石。
  • 安装 rust-gdb / rust-lldb： 这是 Rust 为调试器做的“增强补丁”，能更好地展示 Rust 特有的类型信息。通过 rustup component add rust-src llvm-tools-preview 来安装。
  • 如果习惯使用 VS Code，强烈建议安装 CodeLLDB 扩展，它能提供近乎“开箱即用”的 Rust 调试体验。

二 使用 GDB 或 LLDB 进行源码级调试

工具就位，接下来就是实战。源码级调试能让你像“慢动作回放”一样，看清程序的每一步。

• 构建用于调试的可执行文件： 直接用 cargo build 就行。Rust 的调试构建默认就包含了所有符号信息，无需额外操心。
• 启动调试会话：
  • 使用 GDB：rust-gdb target/debug/your_program
  • 使用 LLDB：rust-lldb target/debug/your_program
• 常用调试命令： 记住这几个，80%的调试场景都能应付。
  • 断点： break main 或 break your_crate::your_function
  • 执行控制： continue（继续）、step（步入）、next（步过）
  • 查看状态： print variable（打印变量）、backtrace（或 bt，查看调用栈）
  • 条件断点： break your_function if variable_name == 42，只在特定条件下触发，非常高效。
• 崩溃时获取回溯： 程序突然崩溃却不知道死在哪里？在运行前设置环境变量 RUST_BACKTRACE=1，它会打印出完整的调用栈，问题根源一目了然。

三 附加到正在运行的进程

有些问题像幽灵，难以稳定复现，只在线上运行时偶尔出现。这时候，“附加调试”就是你的“时间暂停器”。

• 获取进程号： 使用 ps aux | grep your_program 或 pgrep your_program 找到目标进程的 PID。
• 附加调试器：
  • GDB：gdb -p
  • LLDB：lldb -p
• 附加成功后，程序会暂停。此时立刻使用 backtrace、print 等命令检查现场的变量和调用栈，相当于给正在发作的“病症”拍了一张高清快照。

四 系统级与内存问题排查

如果问题不在你的代码逻辑里，而是藏在系统调用或内存深处呢？这就需要更底层的工具来“掘地三尺”。

• 跟踪系统调用： 使用 strace -p 或更精确的 strace -e trace=open,read,write -p 。这招专治各种 I/O 异常、文件找不到、权限不足等“疑难杂症”。
• 跟踪库函数调用： 使用 ltrace -p 。它帮你理清程序调用了哪些动态库函数，适合分析复杂的第三方库交互。
• 内存错误与泄漏检测： 说到内存问题，Valgrind 是公认的利器。运行 valgrind --tool=memcheck target/debug/your_program，它能揪出非法访问、数组越界、使用未初始化内存等隐蔽错误。不过要注意，它会显著降低程序运行速度，适合在测试环境深度排查。

五 IDE 与快速输出辅助

对于日常开发，追求效率至上。图形化调试和快速日志能极大提升幸福感。

• VS Code 调试配置要点：
  • 确保已安装 rust-analyzer 和 CodeLLDB 扩展。
  • 在项目 .vscode/launch.json 中配置调试器：type 设为 cppdbg，MIMode 根据喜好选 gdb 或 lldb，program 指向 target/debug/your_program。关键一步是在 setupCommands 中启用 -enable-pretty-printing，让变量显示更美观。
• 快速打印与日志：
  • 临时探针用 println! 和 dbg! 宏，简单粗暴但有效。dbg!(&variable) 能同时打印出值和所在行号，非常方便。
  • 需要结构化、可分级控制的日志，推荐使用 log 库搭配 env_logger。运行时通过环境变量控制输出级别，比如 RUST_LOG=info cargo run，所有 info 及以上级别的日志都会清晰呈现。