在 Debian 上调试 Rust 的高效方法与工具清单
一 环境准备与符号配置
- 安装调试器与 Rust 增强组件：
- 安装基础工具：sudo apt-get install gdb lldb
- 安装 Rust 调试脚本与源码组件：rustup component add rust-src llvm-tools-preview
- 可选：安装更友好的前端 rust-gdb / rust-lldb（提供更好的 Rust 语法支持和自动加载脚本）
- 确保生成调试符号：
- 开发构建默认包含调试信息；如需在发布构建中也保留符号，配置 Cargo.toml：
- [profile.dev] 保持 debug = true
- [profile.release] 设置 debug = true（发布时仍带符号，便于定位问题）
- 版本建议：使用较新的 GDB（≥ 8.0），其对 Rust 的语法与调用栈解析支持更好。
二 命令行调试流程与常用命令
- 启动会话（以调试版为例）：
- GDB：gdb target/debug/your_binary 或 rust-gdb target/debug/your_binary
- LLDB：lldb target/debug/your_binary 或 rust-lldb target/debug/your_binary
- 常用命令速查：
- 断点与执行：break src/main.rs:10 / run / continue
- 单步：next（不进入函数）/ step（进入函数）
- 观察：print my_var / backtrace（或 bt）
- 管理：info breakpoints / delete 1
- 条件与忽略计数（GDB）：
- 条件断点：break loader.rs:398 if url.contains(“test.swf”)
- 忽略前 N 次：ignore 2 10
- 附加到运行进程：gdb -p $(pidof your_binary)
- 提示：现代 GDB 能较好识别 Rust 命名修饰（mangling）、闭包、枚举 等，可直接打印复杂类型与调用栈。
三 系统级与日志辅助手段
- 系统调用跟踪：strace -p （或限定调用：strace -e trace=open,read,write -p ），定位 I/O、文件、权限等问题
- 库函数跟踪：ltrace -p ，观察动态库调用与参数
- 日志与打印：
- 快速打印：println!(“{:?}”, x)、println!(“{:#?}”, x)（美化输出）、dbg!(&x)（带文件与行号）
- 结构化日志：使用 log + env_logger 等，运行时通过环境变量控制级别（如 RUST_LOG=debug）
- 断言与快速校验：assert!、assert_eq! 在开发与回归测试中快速暴露问题。
四 IDE 与可视化调试
- VS Code + CodeLLDB（推荐组合之一）：
- 安装扩展：CodeLLDB
- 准备组件：rustup component add rust-src
- 配置 launch.json（示例）：
- {
- “version”: “0.2.0”,
- “configurations”: [
- {
- “type”: “lldb”,
- “request”: “launch”,
- “name”: “Debug executable”,
- “cargo”: {
- “args”: [“build”, “–bin=your_binary_name”, “–package=your_package_name”],
- “filter”: { “name”: “your_binary_name”, “kind”: “bin” }
- },
- “args”: [],
- “cwd”: “${workspaceFolder}”
- }
- ]
- }
- 其他 IDE（如 IntelliJ IDEA 的 Rust 插件）亦支持图形化断点、变量与调用栈查看。
五 进阶与常见问题
- 源码路径与自动加载脚本：
- 若调试时源码未对齐，使用 directory /path/to/your/crate/src 添加源码搜索路径
- 使用 rust-gdb / rust-lldb 可自动加载 Rust 的 pretty-printers 与 Python 脚本，提升打印可读性
- 崩溃与最小复现：
- 结合 backtrace 与日志定位入口；必要时用 git bisect 缩小引入问题提交
- 构建最小可复现样例，减少无关噪声
- 内存与不安全代码：
- 使用 Valgrind 检查 unsafe 块或 FFI 相关内存问题（Rust 虽强调内存安全，但 unsafe 场景仍需工具辅助）
- 发布包调试：
- 若需分发调试版 .deb，可用 cargo-deb 打包；调试时仍建议保留调试符号以便分析。
