Go中错误包装核心是用fmt.Errorf配合%w动词或errors.Join、Unwrap等，实现可追溯、信息丰富的错误链；%w嵌入原始错误，保留类型判定能力；需逐层添加上下文；自定义错误类型可实现Unwrap接口；日志中应展开错误链便于调试。
在 Go 中实现错误包装，核心是用 fmt.Errorf 配合 %w 动词或标准库的 errors.Join、errors.Unwrap 等工具，让错误链可追溯、信息更丰富，而不是简单拼接字符串。
使用 %w 包装错误，保留原始错误类型
%w 是 Go 1.13 引入的关键机制，它把底层错误“嵌入”到新错误中，既添加上下文，又不破坏错误的可判定性（比如 errors.Is 和 errors.As 仍能正常工作）。
示例：
func readFile(path string) error {
data, err := os.ReadFile(path)
if err != nil {
return fmt.Errorf("failed to read config file %q: %w", path, err)
}
// ...
return nil
}
// 调用方可以精准判断原始错误类型
if errors.Is(err, os.ErrNotExist) {
log.Println("config file missing")
}
逐层添加上下文，避免丢失关键位置信息
错误包装不是只做一次，而应在每一层调用中补充当前作用域的关键信息（如函数名、参数、阶段标识），形成清晰的错误路径。
立即学习“go语言免费学习笔记（深入）”；
建议方式：
- 在业务逻辑入口处包装一次（如 “处理用户订单时”）
- 在 IO 或依赖调用后立即包装（如 “调用支付网关失败时”）
- 避免在循环或高频路径中过度包装，防止错误链过长
自定义错误类型 + 实现 Unwrap 方法（进阶控制）
当需要携带额外字段（如请求 ID、时间戳、重试次数）或定制错误展示逻辑时，可定义结构体并实现 Unwrap() error 接口：
type RequestError struct {
Err error
ReqID string
Timestamp time.Time
}
func (e *RequestError) Error() string {
return fmt.Sprintf("request %s failed at %s: %v", e.ReqID, e.Timestamp.Format(time.TimeOnly), e.Err)
}
func (e *RequestError) Unwrap() error { return e.Err }
// 使用
err := &RequestError{
Err: io.ErrUnexpectedEOF,
ReqID: "req-789",
Timestamp: time.Now(),
}
这样既能用 errors.Is(err, io.ErrUnexpectedEOF) 判定，又能通过类型断言获取结构体字段。
打印/日志时展开错误链，提升调试效率
默认 fmt.Println(err) 只显示最外层信息。要查看完整链路，可用 fmt.Printf("%+v", err)（需配合 github.com/pkg/errors 或 Go 1.20+ 的 errors.Format）；更推荐在日志中显式遍历：
func logErrorChain(err error) {
for i := 0; err != nil; i++ {
log.Printf("error[%d]: %v", i, err)
err = errors.Unwrap(err)
}
}
生产环境建议结合结构化日志（如 zap、zerolog），将错误链转为 JSON 字段，方便检索和追踪。
