Go 1.13+ 应用 errors.Is 和 errors.As 时需避免字符串匹配，改用语义判断：errors.Is(err, target) 逐层 Unwrap 匹配底层错误；errors.As(err, &target) 提取任意层级自定义错误字段；自定义错误必须实现 Unwrap() 返回被包装 error 或 nil，且不可有副作用；%w 仅用于需保留原始上下文的场景，非错误值或语义替代时不适用。
Go 1.13+ 的 errors.Is 和 errors.As 怎么用才不踩坑
Go 错误链（error wrapping）的核心不是“怎么包”，而是“怎么解”。从 Go 1.13 开始，fmt.Errorf 支持 %w 动词包装错误，但真正关键的是后续的判断与提取逻辑。
常见错误是直接用 == 或 strings.Contains(err.Error(), "...") 判断底层错误——这会绕过整个错误链，一旦中间层加了新包装就失效。
-
errors.Is(err, io.EOF)会逐层调用Unwrap()，直到匹配或返回 nil；它只认“语义相等”，不依赖字符串 -
errors.As(err, &target)尝试将任意层级的错误赋值给目标类型指针，适合提取自定义错误字段（比如*MyAppError中的Code或TraceID） - 若手动实现
Unwrap() error，注意返回nil表示链终止；返回自身会导致无限循环
自定义错误类型如何正确支持错误链
要让自己的错误参与标准链式操作，必须同时满足两个条件：实现 error 接口 + 提供 Unwrap() error 方法。光有 fmt.String() 没用。
典型错误写法：type MyErr struct{ msg string } 只实现了 Error()，没 Unwrap()，errors.Is 就无法穿透它。
立即学习“go语言免费学习笔记（深入）”；
- 如果错误不含下层错误（终端错误），
Unwrap()应返回nil - 如果包装了其他错误（如
fmt.Errorf("failed to parse: %w", err)），Unwrap()必须返回那个被包装的err - 避免在
Unwrap()中做计算或日志——它可能被频繁调用，且预期是无副作用的
type ValidationError struct {
Field string
Err error // 包装的原始错误
}
func (e *ValidationError) Error() string { return "validation failed" }
func (e *ValidationError) Unwrap() error { return e.Err } // 关键：暴露下层
什么时候该用 %w，什么时候不该用
%w 不是万能胶水。滥用会导致错误链过长、语义模糊，甚至掩盖真正原因。
适用场景：明确需要保留原始错误上下文，且上层错误不改变失败本质。比如网络请求失败时，把 net.OpError 包进 ServiceCallError 是合理的。
- 不要用
%w包装非错误值（如fmt.Errorf("id is empty: %w", "")）——编译不报错但运行 panic - 不要在日志或用户提示中直接打印完整链（
fmt.Printf("%+v", err)），除非调试；生产环境应控制输出深度 - 若上层错误已完全替代含义（例如“配置文件不存在” → “使用默认配置”，不再失败），就不该用
%w，否则errors.Is(err, os.ErrNotExist)仍会返回 true，误导调用方
调试时如何快速查看错误链结构
标准 fmt.Println(err) 只显示最外层消息；fmt.Printf("%+v", err) 会触发 github.com/pkg/errors 风格的栈追踪（仅当错误类型实现了 Formatter 接口），但原生 fmt 不提供此能力。
更可靠的方式是手写一个简易遍历器：
func PrintErrorChain(err error) {
for i := 0; err != nil; i++ {
fmt.Printf("%d. %s\n", i, err.Error())
err = errors.Unwrap(err)
}
}
注意：这个循环不会显示栈帧，也不会识别重复包装；真正的链深度和内容取决于每个 Unwrap() 的实现是否规范。很多第三方库（如 go-errors）会额外注入调用位置，但原生链本身不包含栈信息——这是有意设计，避免性能开销。
最容易被忽略的一点：错误链不是日志。它不自动记录时间、goroutine ID 或 HTTP 请求 ID；需要手动把 trace ID 存入自定义错误字段，并通过 errors.As 提取，才能串联观测系统。
