Go 1.13 引入错误包装机制，通过 fmt.Errorf 的 %w 动词将错误嵌入新错误中，形成可追溯的链式结构；标准库提供 errors.Is、errors.As 和 errors.Unwrap 函数用于判断、提取和解析包装错误，支持多层上下文添加，提升调试能力；使用时应避免冗余包装，确保正确使用 %w 并保留完整错误链以增强可读性与排查效率。
在 Go 语言中，错误处理一直以简洁直接著称，但原始的 error 类型缺乏上下文信息，导致调试困难。从 Go 1.13 开始，标准库引入了错误包装（Error Wrapping）机制，让开发者可以在不丢失原始错误的前提下添加上下文信息。这极大提升了错误追踪和问题定位的能力。
错误包装的基本语法：%w 格式动词
Go 通过在 fmt.Errorf 中使用 %w 动词实现错误包装。它会将一个已有错误嵌入新错误中，形成链式结构。
if err := readFile("config.json"); err != nil {
return fmt.Errorf("failed to read config file: %w", err)
}
这里，%w 把底层的 err 包装进新的错误信息中。调用方可以通过标准库函数如 errors.Unwrap、errors.Is 和 errors.As 访问原始错误。
如何判断和提取包装的错误
标准库提供了三个关键函数来操作包装后的错误：
立即学习“go语言免费学习笔记（深入）”；
- errors.Is(err, target)：判断错误链中是否包含指定目标错误，类似于语义上的“等于”。
- errors.As(err, &target)：尝试将错误链中的某个错误转换为指定类型，用于获取具体错误值。
-
errors.Unwrap(err)：返回被包装的下一层错误，若无则返回
nil。
wrappedErr := fmt.Errorf("processing failed: %w", os.ErrNotExist)
// 判断是否是 ErrNotExist
if errors.Is(wrappedErr, os.ErrNotExist) {
log.Println("File does not exist")
}
// 提取特定类型的错误
var pathErr *os.PathError
if errors.As(wrappedErr, &pathErr) {
log.Printf("Path error on: %s", pathErr.Path)
}
多层包装与上下文增强
错误可以被多次包装，形成一条错误链。每一层都可以添加更丰富的上下文，比如操作步骤、参数信息或时间戳。
例如：
func processUser(id string) error {
if err := fetchUser(id); err != nil {
return fmt.Errorf("fetching user %s: %w", id, err)
}
// ...
}
func fetchUser(id string) error {
return fmt.Errorf("database query failed: %w", sql.ErrNoRows)
}
最终错误可能长这样：
fetching user 123: database query failed: no rows in result set
调用方既能通过 errors.Is(..., sql.ErrNoRows) 检查业务逻辑，也能看到完整的执行路径。
注意事项与最佳实践
使用错误包装时需注意以下几点：
- 只在需要增加有意义上下文时才包装，避免无意义的包装层级。
- 不要用
%v或%s替代%w，否则不会形成可解析的包装关系。 - 确保被包装的错误实现了
Unwrap() error方法（fmt.Errorf自动处理）。 - 日志中打印错误时，建议直接输出完整错误字符串，保留上下文链。
基本上就这些。合理使用错误包装，能让 Go 程序的错误更清晰、更易排查。
