这是一篇关于 Rust 错误处理的指南，涵盖了动态错误处理和结构化错误处理等方面，主要内容如下：

• 引言：Rust 提供了多种错误处理方式，本指南将帮助开发者做出正确决策。错误处理很重要，良好的错误处理能让用户对代码印象深刻。

• Rust 错误处理基础：

  • 在 Rust 中，实现了std::error::Error trait 的类型就是错误。多数情况下，只需实现Debug和Display即可。Error::source的返回类型&(dyn Error + 'static)涉及到动态错误的相关知识。
  • std::result::Result::Err包裹的类型不需要Error绑定，开发者可自由选择表示错误的类型，但应尽量使用Error实现。

• 动态错误处理在 Rust 中：

  • Box<dyn Error>是最模糊的错误类型，适合快速传达错误信息，但不利于提供结构化数据供错误处理程序处理。在某些情况下，如输入垃圾数据，使用Box<dyn Error>返回友好的错误消息是合理的。
  • 处理来自其他代码的动态错误时，可能需要进行向下转型（downcasting），但应避免强迫调用者进行向下转型，以免泄露实现细节。
  • anyhow是 Rust 中用于处理错误的常用库，它提供了方便的方式来包装和添加错误上下文。
  • 错误处理的选择取决于错误的受众和他们对错误的处理方式，动态错误适合简单的错误反馈，结构化错误则更适合程序式处理。

• Rust 中的结构化错误处理：

  • 良好的 API 应支持程序式错误处理，避免依赖不可变的错误消息，以免破坏依赖这些消息的代码。
  • 使用枚举（enum）可以构建表达性强的 Rust 错误，清晰地列出所有可能的错误情况，方便调用者进行程序式处理。
  • 可以通过组合多个错误类型来处理复杂的错误情况，thiserror库可以简化错误类型的定义和构造。
  • 列举了tracing和wgpu等 Rust 生态系统中的结构化错误处理示例。
  • std::io::Error是 Rust 标准库中较难处理的错误类型，它试图在各种操作系统上表示所有可能的 IO 错误，导致错误定义不够紧凑。
• 异常情况下的错误处理：介绍了panic!、no_std和 FFIs 等特殊情况下的错误处理相关内容。

总之，Rust 提供了多种错误处理方式，开发者应根据具体情况选择合适的方式，避免一些常见的错误处理陷阱。