错误包装的常见方法有使用%w、第三方库pkg/errors和自定义错误类型。1. 使用%w可简洁包装错误并支持unwrap、is和as操作，但仅限单错误包装；2. pkg/errors提供wrap和withmessage方法增强堆栈信息，适合调试需求；3. 自定义错误类型灵活封装额外信息如操作类型，需实现error和unwrap方法。判断错误时常用errors.is()匹配特定值，errors.as()提取具体类型，并自动遍历错误链。选择合适方式能提升错误处理清晰度与排查效率。
在写 Go 项目时，我们经常会遇到需要把底层错误“包装”起来的情况。比如调用数据库失败、网络请求出错，这时候如果不加处理直接返回原始错误，上层逻辑很难知道到底出了什么问题。所以，我们需要一种方式，既能保留原始错误信息，又能加上当前上下文的描述，这样排查问题更方便。
Go 1.13 引入了 errors.Unwrap 和 %w 的方式来支持错误包装，而后续的版本也在不断完善相关功能。下面我们就来看看几种常见且实用的方法。
错误包装的基本做法：使用 %w
最简单也最常见的错误包装方式，就是在 fmt.Errorf 中使用 %w 来封装底层错误：
立即学习“go语言免费学习笔记（深入）”；
if err := doSomething(); err != nil {
return fmt.Errorf("doSomething failed: %w", err)
}这样做之后，你可以用 errors.Unwrap() 或者 errors.Is()、errors.As() 来判断原始错误类型。比如：
if errors.Is(err, os.ErrNotExist) {
// 处理文件不存在的情况
}这种方式的优点是简洁明了，适合大多数场景。但它的缺点也很明显：只能包装一个错误，而且每次包装都要手动加一句。
使用 github.com/pkg/errors 增强堆栈信息
虽然标准库已经支持了错误包装，但它默认不会记录堆栈信息。如果你希望调试时能知道错误是在哪一层发生的，可以考虑引入第三方库，比如 pkg/errors。
它提供了两个常用方法：
-
Wrap(err, "message")：添加上下文信息并保留原错误 -
WithMessage(err, "message")：只附加信息不记录堆栈（轻量）
例如：
if err := doSomething(); err != nil {
return errors.Wrap(err, "failed to do something")
}打印错误时可以用 errors.Print(err) 查看完整的堆栈路径，对调试非常有帮助。
不过要注意的是，这个库是非标准的，如果你希望保持代码干净或者依赖尽量少，可以选择下一节提到的方式。
自定义错误类型实现上下文封装
有时候你可能希望封装更多信息，比如错误码、操作类型、重试建议等。这时候可以自定义错误类型：
type MyError struct {
Op string
Err error
}
func (e *MyError) Error() string {
return fmt.Sprintf("%s: %v", e.Op, e.Err)
}
func (e *MyError) Unwrap() error {
return e.Err
}使用的时候：
if err := doSomething(); err != nil {
return &MyError{Op: "read config", Err: err}
}这种方式灵活性很高，适合大型项目或中间件开发。但也要注意别过度设计，除非你确实需要这些额外的信息。
判断和提取错误：Is 和 As 的使用技巧
当你层层包装错误后，想判断某个错误是否是特定类型或者具体值，就可以用 errors.Is() 和 errors.As()。
举个例子：
if errors.Is(err, io.EOF) {
// 处理 EOF
}
var netErr net.Error
if errors.As(err, &netErr) && netErr.Timeout() {
// 处理超时
}这两个函数会自动遍历整个错误链，找到匹配的部分。这是比直接比较错误更可靠的做法。
需要注意的一点是，如果你想让你的自定义错误也能被识别，必须实现 Unwrap() 方法。
基本上就这些。Go 的错误处理机制虽然不像其他语言那样有异常捕获，但通过包装和上下文传递，其实也可以做到清晰可控。关键是要根据项目规模选择合适的封装方式，既不要过于复杂，也不要忽略上下文信息。
