Go 1.13 引入错误包装机制，核心是 fmt.Errorf 的 %w 动词及 errors.Unwrap、errors.Is、errors.As 函数，支持错误链式判断与安全提取，提升可诊断性与可恢复性。
Go 1.13 引入了标准的错误包装（error wrapping）机制，核心是 fmt.Errorf 的 %w 动词和 errors 包中的一组函数（errors.Unwrap、errors.Is、errors.As）。它让错误能携带原始原因、支持链式判断，又不破坏原有语义。
用 %w 包装错误，保留原始错误链
使用 %w 是最常用、最推荐的包装方式。它会把传入的 error 作为“原因”嵌入新错误中，且该错误可被后续的 errors.Unwrap 提取。
示例：
if err != nil {
return fmt.Errorf("failed to open config file: %w", err)
}
这里 err 被完整包裹，调用方可用 errors.Is(err, os.ErrNotExist) 判断是否因文件不存在而失败，也可用 errors.As(err, &pathErr) 提取底层 *os.PathError。
errors.Is：跨多层判断错误是否由某个目标错误引起
errors.Is 会沿着 Unwrap() 链向上查找，只要某一层返回的错误与目标相等（或实现了 Is(error) 方法并返回 true），就返回 true。
常见用法：
- 检查是否是系统级错误：
errors.Is(err, os.ErrPermission) - 检查自定义错误类型：
errors.Is(err, ErrTimeout) - 兼容旧版字符串匹配逻辑（但更健壮）
errors.As：安全提取底层具体错误类型
当需要访问被包装错误的具体字段或方法时，用 errors.As。它会遍历整个错误链，找到第一个能赋值给目标类型的错误实例。
示例：
var pathErr *os.PathError
if errors.As(err, &pathErr) {
log.Printf("Failed on path: %s", pathErr.Path)
}
注意：传入的是指针地址（&pathErr），不是值；如果错误链里没有 *os.PathError，则返回 false，pathErr 保持零值。
errors.Unwrap：手动展开一层，慎用
errors.Unwrap 只解一层包装，返回内部错误（如果存在），否则返回 nil。一般不建议直接用它做业务逻辑判断——应优先用 Is 或 As。
典型场景：
- 调试时打印完整错误链：
for err != nil { log.Print(err); err = errors.Unwrap(err) } - 实现自定义错误类型的
Unwrap()方法（需返回被包装的 error）
自定义包装错误示例：
type MyError struct {
Msg string
Err error
}
func (e *MyError) Error() string { return e.Msg }
func (e *MyError) Unwrap() error { return e.Err }
这样它就能被 errors.Is 和 errors.As 正确识别。
基本上就这些。包装不是为了堆叠信息，而是为了可诊断、可判断、可恢复。用好 %w 和三个 errors 函数，Go 的错误处理就真正活起来了。
