Rust 错误处理新纪元：`stackerror` 整合效率、调试与控制流

Rust 社区在错误处理机制上持续演进，旨在平衡开发效率、调试便捷性与运行时精确控制。现有的 `Result<T, &'static str>` 过于简陋，`anyhow` 虽提升了上下文信息和传播效率，但在运行时处理特定错误时需依赖“下推转换”（downcasting），且将调用者与 `anyhow` 的约定绑定。`thiserror` 则允许细粒度的错误枚举，便于运行时匹配，但增加了开发时的配置开销，且可能因内部实现变动导致 API 不稳定。

`stackerror` 库应运而生，它整合了 `anyhow` 的易用性和 `thiserror` 的精确性。该库通过错误代码（error codes）实现运行时控制流匹配，并能堆叠（stack）上下文信息以提供丰富的调试线索。其核心优势在于，开发者可以像使用 `anyhow` 一样快速编写代码，同时获得类似 `thiserror` 的运行时精确匹配能力，并能将错误信息与发生地点（文件、行号）绑定，极大地优化了调试体验。此外，它允许库作者暴露一个单一、不透明的错误类型，同时保留结构化的错误代码以供调用方进行精确处理，避免了将内部实现细节暴露给外部的风险。

`stackerror` 的设计理念是分离调试信息与运行时控制流的需要。对于需要重试或特定响应的错误（如 HTTP 429），开发者可以利用其错误代码进行逻辑判断。而对于调试，堆叠的上下文信息则能提供清晰的失败路径。此模式在 Rust 生态中已广泛存在，如 `std::io::Error` 的 `ErrorKind`、`serde_json::Error` 的 `Category` 等，`stackerror` 将此模式进行了系统化和易用化，允许自定义错误代码，并能根据业务需求扩展，最终实现“快速编写、轻松调试、精确处理”的错误处理流程。

Stackerror

Ergonomic errors in Rust: write fast, debug with ease, handle precisely

gmcgoldr’s blog