使用 pkg/errors 库可在 golang 中实现错误堆栈追踪。1. 通过 errors.wrap(err, "message") 在每层函数中包装错误，保留调用路径；2. 使用 fmt.printf("%+v", err) 输出完整堆栈信息；3. 利用 errors.cause() 获取原始错误以便类型判断；4. 安装方式为 go get github.com/pkg/errors 并在代码中导入使用。
在Golang中，默认的错误处理机制比较简单，只能返回一个
error接口，无法直接追踪错误发生时的调用堆栈。如果你希望记录错误发生的完整路径，方便排查问题，可以使用第三方库
pkg/errors来实现错误堆栈追踪。
这个库提供了
Wrap和
Cause等方法，可以在错误传递过程中保留堆栈信息，同时也支持与标准库中的
errors包兼容。
安装 pkg/errors
首先需要安装这个库：
立即学习“go语言免费学习笔记（深入）”；
go get github.com/pkg/errors
然后就可以在代码中导入并使用它了：
import "github.com/pkg/errors"
如何使用 Wrap 添加堆栈信息
在函数调用链中，每层函数如果对错误进行了处理或包装，都应该使用
errors.Wrap(err, "message")方法来添加当前层级的信息和堆栈。
举个例子：
func readFile() error {
content, err := os.ReadFile("file.txt")
if err != nil {
return errors.Wrap(err, "读取文件失败")
}
fmt.Println(string(content))
return nil
}
func processFile() error {
err := readFile()
if err != nil {
return errors.Wrap(err, "处理文件时出错")
}
return nil
}当
os.ReadFile出错时，
readFile()会将错误包装一层，加上自己的描述。接着
processFile()再次包装，这样最终的错误信息中就包含了完整的调用路径。
如何输出完整的错误堆栈
默认情况下，Go 的
fmt.Println(err)只会输出错误字符串，不会显示堆栈。要打印完整的堆栈信息，需要用
errors.WithStack()或者直接使用
fmt.Printf("%+v\n", err)。
比如：
err := processFile()
if err != nil {
fmt.Printf("%+v\n", err)
}这样就能看到每一层错误的调用位置（文件名和行号），帮助你快速定位问题根源。
如何判断错误类型或原始错误
有时候你需要判断某个错误是不是特定类型，或者获取最底层的原始错误。这时候可以用
errors.Cause()：
if errors.Cause(err) == os.ErrNotExist {
fmt.Println("文件不存在")
}也可以结合类型断言一起使用：
if e, ok := errors.Cause(err).(*os.PathError); ok {
fmt.Println("路径错误：", e.Path)
}这种方式能避免因为多层包装导致类型判断失败的问题。
实际开发中的一些建议
- 不要过度包装：每个函数都 Wrap 是有代价的，建议只在关键节点做包装。
-
日志中打印 %+v：调试时用
%+v
打印详细堆栈，但上线后可能只需普通输出。 - 统一错误结构：可以结合自定义错误类型 + pkg/errors 使用，保持一致性。
基本上就这些。用好
pkg/errors能显著提升 Go 项目中错误的可追踪性，虽然不是官方方案，但在实际开发中非常实用。
