Skip to main content

1 / 4概念

Error

读完能设计一条从产生到上报的错误链,判断该用哨兵错误、自定义类型还是包装,并说清包的导出面为什么是一种长期契约。错误处理与包边界是同一件事:错误在哪一层被翻译,边界就画在哪一层。

1 概念​

1.1 一句话定义​

error 是一个只有 Error() string 方法的接口;错误通过返回值传播,用 %w、errors.Is、errors.As、errors.Join 保留和判断原因;包是导出的最小单位,导出标识符即公开 API。

1.2 它解决什么问题​

  • 失败可判断:哨兵与自定义类型让调用方按语义分支,而不是比较字符串。
  • 原因可保留:包装链保存底层错误,日志能还原现场。
  • 崩溃可控:panic 与 recover 限制在进程或 goroutine 边界。
  • 依赖可约束:internal/ 与导入图阻止越界依赖和循环。
  • 契约可演化:导出面与弃用注释让升级可预期。

1.3 不属于本页的内容​

主题去哪
go.mod、版本解析与构建Go Toolchain
goroutine 内错误传播与取消Goroutines and Channels
HTTP 错误响应与状态码Gin / Echo
接口机制与方法集Interfaces and Generics
静态检查与 lint 规则Code Quality

1.4 关键术语​

术语含义容易混淆的点
error只有 Error 方法的接口不是异常,也没有栈帧展开语义
哨兵错误包级 ErrX 变量用 errors.Is 比较,不用 == 比较包装后的值
自定义错误实现 error 的结构体指针接收者更常见
包装%w 或 Unwrap只有 %w 建立标准链
errors.Is沿链比较目标不是字符串包含
errors.As沿链查找类型目标必须是非 nil 指针
errors.Join合并多个错误全为 nil 时返回 nil
panic展开当前 goroutine 的栈不是跨 goroutine 异常
recover在 defer 中恢复只能恢复同一 goroutine
internal限制导入范围不是访问控制或加密