跳到主要内容

1 / 4概念

Error

Rust 没有异常,失败是普通返回值:Result<T, E> 表示可恢复错误,Option<T> 表示值可能缺失,panic! 表示不变量被破坏。判断标准不是“错误类型写得多细”,而是调用方能否区分失败原因、日志能否还原调用链、panic 是否只出现在真正的 bug 上。

1 概念​

1.1 一句话定义​

错误是值:Result<T, E> 把成功与失败放进同一个枚举,? 在 Err 时通过 From 转换并提前返回,thiserror 生成具体错误类型,anyhow 在应用层聚合上下文,panic! 用于不可恢复的违约。

1.2 它解决什么问题​

  • 异常把失败路径藏在签名之外,调用方容易忘记处理;错误信息层层丢失,日志只剩“操作失败”。
  • 每层都定义新错误类型,调用方无法匹配,类型爆炸。
  • unwrap 把可恢复错误升级成进程崩溃。
  • 业务失败与编程错误混在一起,无法决定重试还是告警。

1.3 不属于本页的内容​

主题去哪
枚举、泛型与 trait 基础OOP
dyn 对象与 trait 对象安全OOP、AOP
异步任务失败与 JoinErrorAsync
日志、指标与追踪后端可观测性章节
FFI 的 panic 边界、退出码与信号Interop、平台章节

1.4 关键术语​

术语含义容易混淆的点
Result<T, E>成功值或错误值不是异常
Option<T>有值或无值不携带失败原因
?失败时提前返回不是 try/catch
From错误类型转换一个来源只能有一个 From
Error trait错误的标准契约Display 与 Debug 分工不同
source下层错误不自动打印
thiserror生成错误类型实现面向库作者
anyhow类型擦除的应用错误面向应用层
context附加的上下文消息不是新的错误类型
panic不可恢复的终止不是业务错误
unwind / abort栈展开 / 直接终止后者不可捕获