使用 pkg/errors 可为 Go 错误添加调用栈，通过 errors.New 创建错误，errors.Wrap 包装并记录上下文，fmt.Printf("%+v") 输出完整堆栈，提升排查效率。
在Go语言中，原生的
error类型不包含调用栈信息，这在排查错误时非常不便。为了增强错误的可追溯性，可以集成
pkg/errors或使用
go-stack等第三方库来为错误添加调用栈信息。以下是具体实现方式。
使用 pkg/errors 添加调用栈
pkg/errors是目前最常用的增强错误处理的库，它支持在不丢失原始错误的前提下，添加调用栈和上下文信息。 安装：
go get github.com/pkg/errors基本用法：
通过
errors.New和
errors.Wrap可以创建带堆栈的错误，
errors.WithStack则直接为已有错误添加堆栈。
立即学习“go语言免费学习笔记（深入）”；
示例代码：
package main
import (
"fmt"
"github.com/pkg/errors"
)
func functionA() error {
return functionB()
}
func functionB() error {
return errors.New("something went wrong")
}
func main() {
err := functionA()
if err != nil {
fmt.Printf("%+v\n", err) // %+v 才会打印堆栈
}
}
输出会包含完整的调用栈，包括出错的文件、行号和函数名。
包装已有错误：
if err != nil {
return errors.Wrap(err, "failed to process data")
}
这样既保留了原始错误，又添加了上下文和堆栈。
使用 go-stack 获取调用栈（辅助方案）
go-stack不直接处理错误，但可以获取当前调用栈信息，适合与自定义错误类型结合使用。 安装：
go get github.com/go-stack/stack使用示例：
package main
import (
"fmt"
"github.com/go-stack/stack"
)
type stackError struct {
msg string
stack stack.CallStack
}
func (e *stackError) Error() string {
return fmt.Sprintf("%s\nStack:\n%v", e.msg, e.stack)
}
func functionX() error {
// 获取前5层调用栈
cs := stack.Caller(1).Stack(0, 5, nil)
return &stackError{
msg: "custom error occurred",
stack: cs,
}
}
func main() {
err := functionX()
fmt.Println(err)
}
这种方式更灵活，但需要自己管理错误结构和格式化输出。
推荐实践：统一使用 pkg/errors
对于大多数项目，
pkg/errors已经足够强大且易于集成。建议：
- 在错误生成点使用
errors.New
或errors.Errorf
- 在错误传递时使用
errors.Wrap
添加上下文 - 打印错误时使用
%+v
格式化，确保堆栈输出 - 避免频繁使用
errors.WithStack
造成堆栈重复
Go 1.13+ 虽然引入了
fmt.Errorf("%w") 和 errors.Unwrap，但缺少自动堆栈追踪，因此
pkg/errors仍是更完整的解决方案。
基本上就这些，集成后能显著提升错误排查效率。
