Go 1.13 的 errors 包通过 %w 动词实现错误包装,支持 errors.Is 语义判断、errors.As 类型提取及 errors.Unwrap 链式调试,提升错误溯源与处理可靠性。

Go 1.13 引入的 errors 包(配合 fmt.Errorf 的 %w 动词)让错误处理从“字符串拼接”升级为“可编程的错误链”,核心是支持错误包装(wrapping)、动态检查(unwrapping)和上下文增强。
用 %w 包装底层错误,保留原始信息
调用下游函数出错时,不要丢掉原始错误,而是用 %w 将其嵌入新错误中。这样既添加了当前层语义,又不破坏错误溯源能力。
-
✅ 正确写法:
return fmt.Errorf("failed to read config: %w", os.Open("config.json")) -
❌ 错误写法:
return errors.New("failed to read config")(丢失原始错误类型和细节)
用 errors.Is 判断错误是否属于某类
不再依赖字符串匹配或类型断言,直接按语义判断错误是否由某个特定错误(如 os.ErrNotExist)引发,即使它被多层包装过。
- 例如:
if errors.Is(err, os.ErrNotExist) { ... }能正确识别fmt.Errorf("loading file: %w", os.ErrNotExist) - 适用于处理常见系统错误、自定义哨兵错误(sentinel errors)
用 errors.As 提取底层错误实例
当需要访问被包装错误的具体字段或方法(比如获取 HTTP 状态码、数据库错误码),用 errors.As 安全地向下展开并类型断言。
- 例如:
var e *json.SyntaxError; if errors.As(err, &e) { log.Printf("JSON syntax error at %v", e.Offset) } - 避免手动循环调用
errors.Unwrap,更安全、更简洁
用 errors.Unwrap 或 %w 链式调试
开发阶段可打印完整错误链帮助定位问题;生产环境建议用日志库(如 zap)自动展开包装错误。
- 简单调试:
for err != nil { log.Print(err); err = errors.Unwrap(err) } - 注意:
%w只能包装一个错误,如需多个原因,应封装为自定义错误类型
基本上就这些。Go errors 包不是替代自定义错误类型,而是让包装、检查、调试变得更统一和可靠——关键在坚持用 %w 包装、用 Is/As 检查,而不是只靠 == 或 strings.Contains。










