Rust / 系统课时
断言与 unreachable 的边界
断言与 unreachable 的边界
断言和 unreachable! 都是在运行时维护程序内部约束:前者验证“这里必须成立”,后者声明“这里按设计不可能到达”。它们适合暴露程序错误,不适合把可预期的输入失败伪装成崩溃。
学习目标
- 区分
assert!、debug_assert!与unreachable!的职责 - 判断何时应使用断言,何时应返回
Result - 理解错误使用这些宏会怎样导致 panic
断言表达的是内部不变量
assert! 在条件为 false 时触发 panic,debug 与 release 构建都会保留。assert_eq!、assert_ne! 只是把常见比较写得更清楚,并在失败时提供两侧值。
它们最适合检查调用者和当前模块已经约定好的内部条件。例如某段代码只允许处理 HTTP 状态码范围,那么进入分类逻辑前可以断言范围已经合法。
fn classify_status(status: u16) -> &'static str {
// 这是内部前置条件:调用此函数前应保证状态码处于协议范围。
assert!(
(100..=599).contains(&status),
"invalid HTTP status: {status}"
);
match status {
100..=199 => "informational",
200..=299 => "success",
300..=399 => "redirection",
400..=499 => "client-error",
500..=599 => "server-error",
_ => unreachable!("status range was checked before matching"),
}
}
fn main() {
println!("{}", classify_status(200));
println!("{}", classify_status(404));
}预期输出:
success
client-error如果把 700 传给 classify_status,前面的断言会 panic,因此后面的 _ 分支仍然代表“在已验证约束成立时不可能出现”的情况。
debug_assert 只适合开发期检查
debug_assert! 与 assert! 的语义相似,但通常只在启用 debug_assertions 时执行;Cargo 默认的 debug 构建会启用它,而常见的 release 构建不会。
因此,不能依赖 debug_assert! 保证生产环境安全性或数据正确性。它更适合检查代价较高、但违反后明确说明程序内部存在 bug 的条件。只要条件关系到业务正确性、权限、金额或外部输入,就应使用正常分支处理。
unreachable 声明逻辑上不可能的分支
unreachable! 本质上仍会 panic。它不会让错误输入自动变成“安全不可达”,而是把一个设计假设写进代码:只要前面的约束成立,这个分支就不会执行。
常见场景是穷尽匹配前已经完成更窄范围的验证,或者某个状态机在当前函数入口处已被限定到一组状态。若这个假设后来因重构失效,unreachable! 会把问题迅速暴露出来。
标准库还有不安全的 std::hint::unreachable_unchecked。它与 unreachable! 不同:一旦实际执行到该位置会产生未定义行为,而不是可靠地 panic。除非能严格证明分支永远不可达,否则不要使用它。
Result 与断言怎么选
判断标准不是“这个错误严重不严重”,而是失败是否属于程序正常运行时可预期的情况。
| 情况 | 合适表达 |
|---|---|
| 用户输入格式错误、文件不存在、网络失败 | Result 或 Option |
| 模块内部必须始终成立的不变量 | assert! / assert_eq! |
| 仅希望开发期发现昂贵的一致性检查 | debug_assert! |
| 在已验证约束下逻辑上不可能到达的分支 | unreachable! |
断言的价值在于让“程序员错误”尽早暴露;Result 的价值在于让“运行时可恢复失败”继续沿正常控制流处理。两者边界清楚,panic 才不会被误用成普通错误通道。