Go errors包怎么用？错误处理全解析

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。