使用%w包装错误可保留原始上下文，结合errors.Unwrap、Is、As实现链式判断与类型匹配，合理添加操作步骤和参数信息，避免冗余，提升错误可读性与排查效率。
在 Golang 中，错误处理是程序健壮性的关键部分。随着项目复杂度上升，原始的 error 值往往不足以说明问题发生的上下文。通过错误包装（Error Wrapping），我们可以在不丢失原始错误的前提下，附加调用栈、操作步骤、参数信息等上下文，帮助快速定位问题。
理解错误包装的核心机制
Golang 从 1.13 版本开始引入了对错误包装的原生支持，主要依赖两个特性：%w 格式动词 和 errors.Unwrap、errors.Is、errors.As 等工具函数。
使用 fmt.Errorf 配合 %w 可以将一个已有的错误包装进新错误中：
if err != nil {
return fmt.Errorf("failed to process user %d: %w", userID, err)
}
这样生成的错误保留了原始错误链，后续可通过 errors.Unwrap() 获取被包装的错误，也可以用 errors.Is() 判断是否包含某个特定错误类型。
立即学习“go语言免费学习笔记（深入）”；
合理添加上下文信息
包装错误时，重点是提供清晰、有用的上下文，而不是堆叠冗余信息。
- 描述当前操作：比如“读取配置文件失败”、“连接数据库超时”
- 附带关键参数：如用户ID、文件路径、URL等
- 避免重复包装同一错误多次，防止信息冗余
示例：
动态WEB网站中的PHP和MySQL详细反映实际程序的需求，仔细地探讨外部数据的验证(例如信用卡卡号的格式)、用户登录以及如何使用模板建立网页的标准外观。动态WEB网站中的PHP和MySQL的内容不仅仅是这些。书中还提到如何串联JavaScript与PHP让用户操作时更快、更方便。还有正确处理用户输入错误的方法，让网站看起来更专业。另外还引入大量来自PEAR外挂函数库的强大功能，对常用的、强大的包
data, err := ioutil.ReadFile(configPath)
if err != nil {
return fmt.Errorf("reading config from %s: %w", configPath, err)
}
使用 errors.As 和 errors.Is 进行错误判断
当需要根据底层错误类型做特殊处理时，应使用 errors.As 或 errors.Is，它们能穿透包装层：
if err := doSomething(); err != nil {
var pathErr *os.PathError
if errors.As(err, &pathErr) {
log.Printf("path error: %v", pathErr.Path)
}
if errors.Is(err, os.ErrNotExist) {
// 处理文件不存在的情况
}
}
这种方式比直接类型断言更安全，也兼容多层包装。
自定义错误类型与包装结合
对于复杂场景，可以定义结构化错误类型，并实现包装能力：
type AppError struct {
Op string
Reason string
Err error
}
func (e *AppError) Error() string {
return fmt.Sprintf("%s: %s: %v", e.Op, e.Reason, e.Err)
}
func (e *AppError) Unwrap() error {
return e.Err
}
创建实例时可包装底层错误：
return &AppError{
Op: "loadUser",
Reason: "user not found",
Err: sql.ErrNoRows,
}
这样既能携带丰富元数据，又能被标准库工具正确解析。
基本上就这些。关键是用好 %w 包装、合理添加上下文、利用 As/Is 安全判断，让错误可读又可查。
