SuperAPI AI 工具集

go-errors

编程与开发

查看项目

更新于 10-16 03:17

技能介绍

用途:这是一份 Go 错误处理规范与参考,用于在编写 Go 代码时统一错误的创建、包装、判断与传播方式。核心原则是错误即值,必须显式处理,预期内的失败不应 panic。

主要能力:涵盖 error 接口定义;用 errors.New 创建简单错误、fmt.Errorf 创建格式化错误、%w 包装错误以保留原因链;errors.Is 判断链中特定错误、errors.As 提取特定错误类型;哨兵错误(Err 前缀、包级 var、谨慎使用并写入 API 契约);自定义错误类型及实现 Unwrap 以支持 Is/As;错误类型 switch;panic 与 recover 的适用边界;以及 ErrorWriter 等减少重复 if err != nil 的模式。

使用方式:按资料中的模式编写,例如包装时用 fmt.Errorf("fetching user: %w", err),判断时用 errors.Is(err, sql.ErrNoRows),提取类型时用 errors.As(err, &pathErr)。%w 保留链,%v 会丢失链。错误字符串应小写开头、不加结尾标点。

适用场景:库与应用的错误设计、HTTP 处理器错误映射、数据库查询错误转换、资源清理时的错误捕获等。

限制:资料未提供安装命令、版本要求或平台信息;示例代码需按实际项目调整,不应照搬。