Rust 错误处理详解：掌握 anyhow、thiserror 和 snafu

错误处理是 Rust 开发中不可或缺的一部分。Rust 的 Result<T, E> 提供了基础支持，但具体实现却因场景而异。本文将介绍三种常用的错误处理工具——anyhow、thiserror 和 snafu，分析它们的特点和适用场景，并通过实战示例帮你理解如何在项目中使用它们。无论你是开发应用还是编写库，这里都能为你提供参考。

本文深入探讨 Rust 错误处理中的三大工具：anyhow 适合快速统一错误处理，适用于应用开发；thiserror 支持自定义错误类型，适合库的开发；snafu 提供上下文驱动的错误管理，适用于复杂系统。通过对比它们的优劣和实际代码演示，我们将展示如何根据项目需求选择合适的工具，并提供项目搭建步骤和示例代码，助你在 Rust 中更好地处理错误。

Rust 错误处理

错误处理：anyhow、thiserror、snafu

• anyhow：统一、简单的错误处理，适用于应用程序级别
• thiserror：自定义、丰富的错误处理，适用于库级别
• snafu：更细粒度的管理错误

注意：开发中需要注意 Result<T, E> 的大小

anyhow Error ：应用程序级错误处理

anyhow Error 的转换与统一错误处理

• 提供统一的 anyhow::Error 类型，支持任意实现 std::error::Error 的错误类型

• 通过 ? 操作符自动传播错误，简化多层嵌套错误处理

• 支持添加动态上下文（context() 方法），提升错误可读性

fn get_cluster_info() -> Result<ClusterMap, anyhow::Error> {  // 错误3 Err3
  let config = std::fs::read_to_string("cluster.json")?;            // 错误1 Err1
  // let config = std::fs::read_to_string("cluster.json").context("...")?;          // 错误1 Err1
  let map: ClusterMap = serde_json::from_str(&config)?;             // 错误2 Err2
  Ok(map)
}

struct Err1 {...}
struct Err2 {...}

match ret {
  Ok(v) => v,
  Err(e) => return Err(e.into)
}

Err1 => Err3: impl From<Err1> for Err3
Err2 => Err3: impl From<Err2> for Err3

impl From<Err1> for Err3 {
  fn from(v: Err1) -> Err3 {
    ...
  }
}

thiserrorError：库级错误定义

• 通过宏自动生成符合 std::error::Error 的错误类型
• 支持嵌套错误源（#[from] 属性）和结构化错误信息
• 允许自定义错误消息模板（如 #[error("Invalid header: {expected}")]）

https://doc.rust-lang.org/beta/core/error/trait.Error.html

因为 Error trait 实现了 Debug 和 Display Trait

pub trait Error: Debug + Display {

所以，可以这样打印：

Error -> println("{}/{:?}", err)

snafu Error ： 上下文驱动的错误管理

• 通过 Snafu 宏将底层错误转换为领域特定错误
• 支持在错误链中附加结构化上下文（如文件路径、输入参数）
• 提供 ensure! 宏简化条件检查与错误抛出

thiserror vs snafu

更多请参考：https://github.com/kube-rs/kube/discussions/453

对比与选型指南