Rust / 系统课时
使用 panic
使用 panic
panic! 适合处理程序无法继续保证正确性的错误。本课将通过可运行示例观察 panic 信息、开启回溯,并判断何时应直接终止程序,何时应改用可恢复的错误处理。
学习目标
- 识别适合使用
panic!的不可恢复场景 - 读懂 panic 位置、消息与调用栈
- 使用
RUST_BACKTRACE开启回溯信息
何时应该 panic
当程序内部的不变量已经被破坏,继续执行可能产生错误数据或安全问题时,可以使用 panic! 立即终止当前线程。典型场景包括数组越界、进入理论上不可能出现的分支,以及测试中发现关键前置条件不成立。
用户输入错误、文件不存在、网络超时等情况通常可以恢复,不应直接 panic。此类错误更适合返回 Result,让调用者决定重试、提示用户或执行降级逻辑。
触发并观察 panic
下面的程序要求除数不能为零。条件不满足时,panic! 会输出自定义消息和触发位置,然后终止程序。
fn divide(dividend: i32, divisor: i32) -> i32 {
// 除数为零会破坏运算前提,因此立即终止
if divisor == 0 {
panic!("divisor must not be zero");
}
dividend / divisor
}
fn main() {
println!("{}", divide(10, 0));
}运行命令:
cargo run预期输出:
thread 'main' panicked at src/main.rs:<LINE>:<COLUMN>:
divisor must not be zero
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace<LINE> 和 <COLUMN> 会随源文件内容变化。第一行指出 panic 所在线程和源码位置,第二行是传给 panic! 的消息。
开启调用栈回溯
当 panic 发生在多层函数调用内部时,仅看触发位置可能不足以定位根因。可以临时设置 RUST_BACKTRACE=1,让 Rust 输出经过的主要调用路径。
RUST_BACKTRACE=1 cargo run预期输出:
thread 'main' panicked at src/main.rs:<LINE>:<COLUMN>:
divisor must not be zero
stack backtrace:
0: <RUNTIME_FRAME>
1: <PROJECT_FRAME>
2: <PROJECT_FRAME>
note: Some details are omitted, run with `RUST_BACKTRACE=full` for a verbose backtrace.不同 Rust 版本和操作系统显示的栈帧数量可能不同。开发环境可使用 RUST_BACKTRACE=full 查看完整回溯,生产环境则应结合日志策略决定是否暴露详细路径。
panic 的展开与直接终止
Rust 默认会在 panic 时执行栈展开,逐层清理已经创建的局部值。项目也可以在构建配置中使用 panic = "abort",让进程不展开栈而直接终止,从而减小部分二进制体积。
直接终止时不会继续执行析构清理,操作系统会回收进程资源。它适合能够由外部进程管理器重启的独立程序,不适合需要在进程内完成收尾工作的场景。
常见误用
不要把 unwrap() 和 expect() 当作日常错误处理方式。它们在遇到 Err 或 None 时同样会 panic,只适合测试、示例代码,或已经通过程序逻辑证明一定成功的位置。
库代码尤其应谨慎 panic,因为调用者无法恢复。除非调用方式违反了明确的 API 契约,否则通常应返回 Result,把错误决定权交给上层。
本课总结
panic!用于程序无法继续保证正确性的不可恢复错误RUST_BACKTRACE=1可以显示主要调用路径,帮助定位触发来源- 可预期且可恢复的失败应优先返回
Result
下一课预告
下一课将使用 Result 表达成功值与错误值,并通过 match 和 ? 分别完成就地处理与向上传播。