使用第三方库如github.com/pkg/errors可为Go错误添加堆栈信息，通过errors.New()、Wrap()等函数捕获调用栈，结合%+v输出详细堆栈，提升错误排查效率。
在Go语言中，错误处理默认不包含堆栈跟踪信息，这使得排查深层调用链中的错误变得困难。为了快速定位问题，我们通常需要为错误添加堆栈信息。虽然标准库 errors 提供了基础功能，但要实现带堆栈的错误追踪，推荐使用第三方库或自定义封装。
使用 pkg/errors 添加堆栈信息
github.com/pkg/errors 是最广泛使用的增强错误库之一，它能在创建或包装错误时自动记录调用堆栈。
基本用法：
-
errors.New()：创建新错误并捕获当前堆栈 -
errors.Wrap(err, msg)：为已有错误添加上下文和堆栈 -
errors.WithStack(err)：保留原错误信息，附加完整堆栈 - 通过
%+v格式化输出可打印完整的堆栈跟踪
示例代码：
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"fmt"
"github.com/pkg/errors"
)
func demo() error {
return inner()
}
func inner() error {
return errors.New("something went wrong")
}
func main() {
err := demo()
if err != nil {
fmt.Printf("%+v\n", err) // 输出带堆栈的详细信息
}
}
使用 github.com/ianlopshire/go-stackerr 快速构建带栈错误
这个库更轻量，适合只需要简单堆栈记录的场景。
-
stackerr.New()直接生成带堆栈的错误 -
stackerr.Wrap()包装已有错误并加堆栈 - 输出时同样使用
%+v查看堆栈
自定义带堆栈的错误类型
如果不想引入外部依赖，可以结合 runtime.Caller() 自行实现简易堆栈捕获。
关键点：
- 定义结构体保存错误消息和调用栈（pc slice）
- 实现
error接口的Error()方法 - 额外提供方法支持格式化输出堆栈（如实现
fmt.Formatter）
虽然灵活性高，但维护成本较高，建议仅在特殊需求下使用。
现代替代方案：使用 errors.Is 和 errors.As 配合堆栈库
Go 1.13+ 引入了 errors.Is 和 errors.As 支持错误 unwrap。配合 pkg/errors 的 Wrap/Unwrap 机制，既能保留堆栈，又能进行语义判断。
例如：
if errors.Is(err, io.ErrClosedPipe) {
// 处理特定错误
}
if target := new(MyCustomError); errors.As(err, &target) {
// 类型断言并处理
}
确保你在使用 pkg/errors 时，用 errors.Cause() 或 Unwrap() 获取根源错误。
基本上就这些常见方式。对于大多数项目，直接使用 github.com/pkg/errors 是最简单有效的选择，能显著提升错误可观测性。注意统一团队的错误处理规范，避免混用多种模式造成混乱。
