Go 1.13引入错误包装机制，通过fmt.Errorf配合%w动词实现上下文添加与链式追踪，结合errors.Is、As和Unwrap可精准判断、转换与解析错误链；业务中应在每层调用时包装底层错误以保留上下文，如数据库操作附带SQL信息；虽标准库不提供堆栈，但可自定义withStack类型捕获调用栈，增强调试能力；日志记录应递归展开错误链输出完整上下文，API返回则需过滤敏感信息；关键在于坚持统一使用%w进行包装，确保错误体系清晰可追溯。
在Go语言中，错误处理是程序健壮性的关键部分。从Go 1.13开始，标准库引入了错误包装（Error Wrapping）机制，使得开发者可以在不丢失原始错误的前提下附加上下文信息，实现更清晰的错误追踪。合理使用这一特性，能显著提升调试效率和系统可观测性。
理解错误包装的核心机制
Go通过 %w 动词实现错误包装。当使用 fmt.Errorf 并配合 %w 时，返回的错误会保留对原始错误的引用，形成链式结构。
标准库中的 errors.Unwrap、errors.Is 和 errors.As 可用于遍历和比对包装链：
- errors.Is(err, target)：判断错误链中是否存在指定目标错误
- errors.As(err, &target)：将错误链中的某一层转换为指定类型
- errors.Unwrap(err)：获取下一层被包装的错误
在业务中添加上下文信息
常见做法是在每一层调用中使用 fmt.Errorf 包装底层错误，附加上当前操作的上下文，例如数据库查询失败时记录SQL语句或参数。
立即学习“go语言免费学习笔记（深入）”；
示例代码：
func queryUser(id int) (*User, error) {row := db.QueryRow("SELECT name FROM users WHERE id = ?", id)
if err := row.Scan(&name); err != nil {
return nil, fmt.Errorf("failed to scan user with id %d: %w", id, err)
}
return &User{Name: name}, nil
}
这样，调用方收到错误时，不仅能知道扫描失败，还能看到具体是哪个用户ID导致的问题，并可通过 errors.Cause 或递归 Unwrap 找到最底层的驱动错误。
自定义错误类型与堆栈追踪
虽然标准错误包装不自带堆栈信息，但可通过自定义错误类型在创建时捕获调用栈，实现类似 pkg/errors 库的功能。
定义一个带堆栈的错误：
type withStack struct {error
*stack
}
func (w *withStack) Unwrap() error { return w.error }
func WithStack(err error) error {
if err == nil {
return nil
}
return &withStack{err, captureStack()}
}
在关键入口或日志记录处，可用 errors.As 检查是否包含堆栈信息并打印完整调用路径，帮助快速定位问题源头。
日志与监控中的错误处理建议
记录错误时应避免只打印表层信息。推荐递归展开错误链，提取所有上下文：
func logError(err error) {for e := err; e != nil; e = errors.Unwrap(e) {
log.Printf("error: %v", e)
}
}
同时，在API响应中应控制敏感信息泄露，对外暴露的错误应做清洗，仅返回用户可理解的信息，内部细节写入日志即可。
基本上就这些。掌握包装语法、善用上下文、必要时补充堆栈，就能构建出清晰可查的错误体系。不复杂但容易忽略的是坚持一致的包装习惯——只要层层传递时都用 %w，追踪就会变得简单很多。
