Rust在Debian中的调试技巧

Rust在Debian中的调试技巧汇总

1. 基础环境准备

在Debian上调试Rust前，需安装必要工具链：

安装Rust：通过rustup安装最新稳定版，添加~/.cargo/bin到PATH：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env

安装调试器：选择gdb（GNU Debugger）或lldb（LLVM Debugger），推荐安装两者以备不同需求：
```
sudo apt update && sudo apt install gdb lldb
```
增强Rust调试支持：安装rust-src（提供Rust源码）和llvm-tools-preview（支持LLVM工具链）：
```
rustup component add rust-src llvm-tools-preview
```

2. 编译优化：保留调试信息

调试时需保留符号表和调试信息，避免使用--release模式（除非需性能分析）：

cargo build  # 默认生成带调试信息的可执行文件（target/debug/your_project）

若需发布模式但保留调试信息，可在Cargo.toml中配置：

[profile.release]
debug = true  # 保留调试符号

3. 核心调试工具：rust-gdb/rust-lldb

Rust提供了针对gdb/lldb的包装器，自动加载Rust调试信息，提升体验：

启动调试会话：

rust-gdb target/debug/your_project  # 使用GDB
rust-lldb target/debug/your_project  # 使用LLDB

常用命令：
- break <函数名/文件:行号>：设置断点（如break main或break src/main.rs:10）；
- next（n）：单步执行（不进入函数）；
- step（s）：单步执行（进入函数）；
- continue（c）：继续执行至下一个断点；
- print <变量名>（p）：打印变量值（如print x）；
- backtrace（bt）：查看调用栈（定位崩溃位置）；
- frame <编号>：切换调用栈帧（查看不同层级的变量）。

4. 快速调试技巧：宏与环境变量

`println!/dbg!“宏”：
- println!("{:?}", 变量)：打印变量值（需手动添加，适合简单调试）；
- dbg!(变量)：更便捷的打印方式，自动输出变量值、文件名及行号（如dbg!(x)）；
- println!("{:#?}", 结构体)：美化打印结构体（显示层级结构）。

RUST_BACKTRACE环境变量：
程序崩溃时，设置该变量获取完整调用回溯（帮助定位崩溃原因）：

RUST_BACKTRACE=1 cargo run  # 临时启用
RUST_BACKTRACE=full cargo run  # 显示完整回溯（包括所有帧）

5. 高级调试工具

Valgrind：检测内存泄漏、非法内存访问（如越界读写）：

sudo apt install valgrind
valgrind --tool=memcheck target/debug/your_project

日志库：使用log+env_logger记录程序运行日志（适合复杂项目）：

use log::{info, error};
fn main() {
    env_logger::init();  // 初始化日志
    info!("Program started");  // 记录info日志
    error!("Something went wrong!");  // 记录error日志
}

运行时设置日志级别：

RUST_LOG=info cargo run  # 显示info及以上级别日志

IDE集成：
- Visual Studio Code：安装rust-analyzer（代码补全）和CodeLLDB（调试）扩展，通过内置调试面板设置断点、查看变量；
- CLion：JetBrains推出的Rust专用IDE，支持Cargo项目管理、调试、测试等功能（需安装Rust插件）。

6. 其他实用技巧

静态编译：避免因glibc版本不兼容导致的问题（如服务器环境），在.cargo/config.toml中配置：
```
[target.x86_64-unknown-linux-gnu]
rustflags = ["-C", "target-feature=+crt-static"]
```
然后编译：
```
cargo build --release
```
保留调试符号：若使用cargo deb打包Debian软件包，默认会剥离调试符号。可通过以下方式保留：
- 在Cargo.toml中设置[profile.release].debug = true；
- 使用cargo deb --separate-debug-symbols将调试符号打包为单独文件（便于后续调试）。
自动重载：使用cargo-watch在文件修改时自动重新编译并运行（加速迭代调试）：
```
cargo install cargo-watch
cargo watch -x run  # 监听文件变化并运行
```