errors.Is / errors.As / errors.Join / %w 全用法汇总
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())
```
