Debian Rust如何进行调试

Debian 上调试 Rust 的实用指南

一 环境准备

• 安装调试器与 Rust 增强组件：
  • 安装系统调试器：sudo apt install gdb lldb
  • 安装 Rust 调试与源码支持：rustup component add rust-src llvm-tools-preview
• 建议始终使用 debug 构建 进行调试（包含调试符号、无优化）：cargo build；仅在需要性能分析时使用 cargo build --release。
• 可选：为 IDE 安装 rust-analyzer（代码分析、断点提示等）。

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

• 启动调试会话（推荐对 debug 产物调试）：
  • GDB：rust-gdb target/debug/your_program
  • LLDB：rust-lldb target/debug/your_program
• 常用调试命令（GDB 与 LLDB 命令相近）：
  • 断点：break main 或 break your_crate::your_function
  • 运行/继续：run / continue
  • 单步：step（进入函数）/ next（跨过函数）
  • 打印：print variable_name
  • 调用栈：backtrace
  • 条件断点：break your_function if variable_name == 42
• 小技巧：在 GDB 中启用 Rust 美化打印，可在初始化时执行：-enable-pretty-printing。

三 系统级与内存问题定位

• 系统调用跟踪：定位 I/O、文件、权限等问题
  • 示例：strace -e trace=open,read,write,close -p 或 strace ./your_program
• 库函数调用跟踪：定位动态库调用问题
  • 示例：ltrace -e ‘malloc,free,printf’ -p 或 ltrace ./your_program
• 内存错误与泄漏检测（仅在 debug 构建上效果最佳）
  • valgrind --tool=memcheck target/debug/your_program
• 提示：strace/ltrace 会对性能产生明显影响，尽量在问题复现的最小场景下使用。

四 日志断言与 IDE 调试

• 快速打印与断点
  • println!(“{ :?} ”, value)、dbg!(& value)（快速查看变量与表达式）
  • 使用 assert! / assert_eq! 捕获不变量与假设
• 结构化日志
  • 使用 log + env_logger：在代码中 env_logger::init(); ，运行时设置 RUST_LOG=info cargo run
• VS Code 调试配置要点
  • 安装扩展：rust-analyzer（语言支持）与 CodeLLDB（C/C++/Rust 调试器）
  • 示例 launch.json（使用 LLDB）： { “version”: “0.2.0”, “configurations”: [ { “type”: “lldb”, “request”: “launch”, “name”: “Debug”, “program”: “${ workspaceFolder} /target/debug/your_program”, “args”: [], “cwd”: “${ workspaceFolder} ”, “preLaunchTask”: “cargo build” } ] }
  • 如需 GDB，可将 type 改为 cppdbg、MIMode 设为 gdb 并配置 miDebuggerPath。

五 打包发布与调试符号管理

• 调试信息默认包含在 dev 与（可配置的）release 配置中；若使用 cargo deb 打包，默认会剥离调试符号。
• 保留调试符号的两种方式：
  • 在 Cargo.toml 中开启 release 调试信息： [profile.release] debug = true
  • 使用 cargo deb --separate-debug-symbols 将调试符号分离打包，便于后续 gdb 加载与符号化回溯。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！