pkg/errors 是一个流行的 go 错误处理库，用于增强错误的可追溯性。它通过 errors.new() 和 errors.errorf() 创建带堆栈信息的错误，并支持使用 errors.wrap() 包装已有错误以附加上下文。打印完整堆栈需使用 fmt.printf("%+v", err)，提取原始错误可用 errors.cause() 或结合 errors.as() 进行类型判断。此外，它兼容 go 1.13 的 unwrap 方法，支持标准库的 errors.is() 和 errors.as() 进行错误断言和提取，便于构建复杂错误处理逻辑。
在Go程序调试过程中，错误信息的堆栈跟踪对于快速定位问题非常重要。标准库中的
errors包虽然能处理基本的错误创建和判断，但缺少堆栈信息的支持。这时候就需要借助第三方库，比如
pkg/errors，来增强错误的可追溯性。
什么是 pkg/errors？
pkg/errors是一个非常流行的Go语言错误处理库，它提供了创建、包装和追踪错误堆栈的能力。相比原生的
errors.New()，它通过添加调用堆栈信息，使得我们在排查错误时能更清楚地知道错误是在哪一层被触发的。
使用它很简单，只需要安装：
立即学习“go语言免费学习笔记（深入）”；
go get github.com/pkg/errors
然后导入即可开始使用。
如何记录错误堆栈？
使用
pkg/errors最核心的功能就是记录错误发生时的堆栈信息。你可以通过以下方式来创建带有堆栈信息的错误：
- 使用
errors.New("something went wrong")创建基础错误，并附带堆栈。 - 使用
errors.Errorf("invalid value %v", val)格式化生成错误。 - 如果你有一个已有的错误（比如来自标准库），可以用
errors.Wrap(err, "additional context")
来包装并附加堆栈。
举个例子：
err := someFunc()
if err != nil {
return errors.Wrap(err, "failed to execute someFunc")
}这样返回的错误不仅包含了原始错误的信息，还加上了当前出错位置的堆栈，便于追踪。
如何提取错误和堆栈信息？
当你需要打印或记录错误信息时，直接使用
fmt.Printf("%+v", err)就可以输出完整的堆栈信息。注意，普通的fmt.Println(err)只会显示错误字符串，不会显示堆栈。
如果你在日志中记录错误，可以结合
log.Printf("%+v", err)或者使用结构化日志库如logrus、
zap等配合输出详细堆栈。
此外，如果你想从一个错误链中找出某个特定类型的错误，可以使用：
errors.Cause(err)
：获取原始错误。- 结合
github.com/pkg/errors/tracer
或其他工具进行深度分析。
错误包装与 unwrap 的兼容性
从 Go 1.13 开始，标准库支持了
Unwrap()方法，用于提取被包装的错误。而
pkg/errors也实现了这一接口，因此你可以使用
errors.Is()和
errors.As()来判断错误类型或提取特定类型的错误对象。
比如：
if target := new(MyCustomError); errors.As(err, &target) {
// 处理 MyCustomError 类型的错误
}这种方式非常适合构建复杂的错误处理逻辑，同时也保持了良好的兼容性和扩展性。
基本上就这些。合理使用
pkg/errors可以极大提升Go项目中错误调试的效率，尤其是在多层函数调用中。关键点在于：记录堆栈、正确包装错误、以及在日志中完整输出。不复杂但容易忽略的是，记得在打印错误时使用
%+v才能看到完整的堆栈路径。
