Go 1.13 错误处理新工具核心是支持错误链的查询、转换与组合:errors.Is 判断链中是否存在目标错误,errors.As 提取指定类型错误,errors.Join 合并多错误,%w 是唯一推荐的包装方式。

Go 1.13 引入的错误处理新工具,核心是让错误链(error chain)可查、可转、可组合。它们不是替代 == 或 errors.New,而是解决“被包装过的错误怎么判断类型/提取原因”这个长期痛点。
errors.Is:判断错误链中是否存在某个目标错误
用于检查一个错误是否等于(或其底层包装链中包含)某个已知错误值(常量或变量),支持多层包装。
- 底层调用
Unwrap()逐层展开,直到匹配到目标错误,或返回nil - 只适用于判断
errors.New、fmt.Errorf带%w包装的错误,或实现了Is(error) bool方法的自定义错误 - 不适用于类型断言(比如想看是不是
*os.PathError,该用errors.As)
示例:
```goerr := fmt.Errorf("failed to read config: %w", os.ErrNotExist)
if errors.Is(err, os.ErrNotExist) {
log.Println("config file missing") // ✅ 匹配成功
}
```
errors.As:从错误链中提取特定类型的错误实例
用于向下转型(type assertion),把错误链里第一个匹配指定类型的错误赋值给目标变量,适合获取底层具体错误信息(如路径、errno 等)。
- 同样递归调用
Unwrap(),找到第一个满足target类型的错误并赋值 -
target必须是指针(如*os.PathError),否则 panic - 返回
bool表示是否成功提取
示例:
```goerr := fmt.Errorf("read failed: %w", &os.PathError{Op: "open", Path: "/etc/config.json", Err: syscall.ENOENT})
var pathErr *os.PathError
if errors.As(err, &pathErr) {
log.Printf("op=%s, path=%s", pathErr.Op, pathErr.Path) // op=open, path=/etc/config.json
}
```
errors.Join:合并多个错误为一个可遍历的复合错误
将零个或多个错误打包成一个 interface{ Unwrap() []error } 类型的错误,便于统一返回(尤其在并发或批量操作中)。
- 返回的错误调用
Unwrap()会返回所有子错误切片(顺序与传入一致) - 它本身不实现
Error()方法,但标准库的fmt包对其实现了友好格式化(如fmt.Errorf("failed: %w", errors.Join(e1,e2))) - 注意:不能直接用
errors.Is或errors.As在Join结果上查单个子错误——需先Unwrap()再逐个查,或用循环配合errors.Is/As
示例:
```goe1 := errors.New("failed to connect")
e2 := errors.New("timeout")
multiErr := errors.Join(e1, e2)
// 手动检查每个子错误
for _, e := range multiErr.(interface{ Unwrap() []error }).Unwrap() {
if errors.Is(e, context.DeadlineExceeded) { /* ... */ }
}
```
%w:格式化时包装错误的标准方式(必须搭配 fmt.Errorf)
在 fmt.Errorf 中使用 %w 动词,表示“将后面的 error 值包装进新错误”,这是构建可追溯错误链的唯一推荐方式。
- 被
%w包装的错误可通过errors.Unwrap()、errors.Is、errors.As向下访问 - 只能用一次(一个
fmt.Errorf中最多一个%w),且必须是最后一个参数 - 不用
%w而用%s或字符串拼接,会导致错误链断裂,无法用Is/As追溯
示例:
```go// ✅ 正确:保留错误链
err := fmt.Errorf("loading module %q failed: %w", name, innerErr)
// ❌ 错误:丢失原始错误信息
err := fmt.Errorf("loading module %q failed: %s", name, innerErr.Error())
```










