SuperAPI AI 工具集

error-handling

编程与开发

查看项目

更新于 10-15 22:39

技能介绍

用途:该技能帮助在代码评审、新功能实现和重构时改进错误处理模式,核心是以“是否可恢复”为标准设计错误,并区分领域错误与系统错误。

主要能力:领域逻辑(业务规则)采用 Either/Result 类型,让调用方通过返回类型即可判断错误可能性;异常仅用于真正的异常状况,而非控制流。判断流程为:错误发生后先判断是否可恢复,可恢复则用 Either/Result 表达,不可恢复则用异常或 panic 立即停止。可恢复错误包括业务规则违反、外部系统错误、权限不足与资源竞争;不可恢复错误包括参数非法、状态矛盾与不可达代码。

使用方式:按语言选择推荐库——TypeScript 用 neverthrow(仅需 Result)或 fp-ts(函数式全般);JavaScript 用 neverthrow;Rust 用标准 Result<T, E>,错误定义用 thiserror;Go 用标准 (T, error) 或 samber/mo;Scala 用标准 Either[L, R];Java 用 vavr.io Either;Python 用 returns 或 result。全语言实现模式与错误类型设计详见 references/guidelines.md。

适用场景:需要改进错误处理模式的代码评审、新实现与重构。

限制:资料未提供安装命令、收费与平台信息;相关技能 error-classification、domain-building-blocks、repository-design 建议一并参考。