使用 pkg/errors 的 Wrap 可添加上下文并保留堆栈，需用 %+v 输出完整调用链，相比标准库错误包装更利于排查问题。
在Go语言中，错误处理是程序健壮性的重要组成部分。从Go 1.13开始，errors.Wrap 并不是标准库的原生功能，而是由第三方库 github.com/pkg/errors 提供的核心特性。它允许你在不丢失原始错误的前提下，添加上下文信息并保留堆栈追踪能力。虽然Go官方在1.13引入了错误包装（via %w）和 errors.Unwrap、errors.Is、errors.As 等机制，但要获得完整的堆栈信息记录，仍推荐使用 pkg/errors 或类似支持堆栈的库。
使用 pkg/errors 实现错误包装与堆栈保留
github.com/pkg/errors 是最广泛使用的增强错误处理库之一。它提供了 Wrap、WithMessage、WithStack 等函数来附加信息或堆栈。
go get github.com/pkg/errors
Wrap 函数的基本用法：当你需要为一个已存在的错误添加上下文，并保留其调用堆栈时，使用 errors.Wrap()。
示例代码：
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"fmt"
"os"
"github.com/pkg/errors"
)
func readFile(path string) error {
_, err := os.Open(path)
if err != nil {
return errors.Wrap(err, "failed to open file")
}
return nil
}
func processFile() error {
return readFile("non-existent.txt")
}
func main() {
err := processFile()
if err != nil {
fmt.Printf("%+v\n", err) // %+v 打印完整堆栈
}
}
输出结果会包含完整的调用堆栈，例如：
failed to open file: open non-existent.txt: no such file or directory
main.readFile
/path/to/main.go:12
main.processFile
/path/to/main.go:17
main.main
/path/to/main.go:22
runtime.main
/usr/local/go/src/runtime/proc.go:250
这里的关键是使用 %+v 格式化输出，才能看到堆栈信息；如果只用 %v，只会显示错误消息链，看不到堆栈。
对比：标准库 errors 和 pkg/errors 的差异
Go 1.13+ 的标准库支持通过 fmt.Errorf("%w", err) 包装错误，也支持 errors.Is 和 errors.As，但它默认不记录堆栈信息。
举例说明：
err := fmt.Errorf("read failed: %w", io.ErrUnexpectedEOF)
fmt.Println(err) // 输出：read failed: unexpected EOF
这种写法可以正确包装错误并支持解包，但没有文件名、行号等调试信息。如果你需要堆栈，必须手动实现或依赖外部库。
而 pkg/errors 在调用 Wrap 或 New 时自动捕获堆栈，极大方便了线上问题排查。
常见操作建议
以下是使用 wrap 功能时的最佳实践：
-
在边界处包装错误：当错误从底层传递到上层逻辑（如从 DAO 层到 service 层），应使用
errors.Wrap添加上下文，而不是裸露原始错误。 - 避免重复包装：不要对已经包装过的错误再层层 Wrap，会导致堆栈冗余或信息重复。
-
使用 %+v 输出日志：在记录错误日志时，始终使用
fmt.Sprintf("%+v", err)或直接打印%+v，确保堆栈被写入日志系统。 -
与标准库兼容性考虑：
pkg/errors返回的错误类型兼容 Go 标准库的包装接口（实现了 Unwrap 方法），所以可以和errors.Is、errors.As混合使用。
替代方案：使用 github.com/getsentry/sentry-go 等现代库
随着生态发展，一些更现代的错误追踪库（如 Sentry SDK）也内置了堆栈收集能力，并与分布式追踪集成。但在大多数场景下，pkg/errors 依然是轻量且高效的首选。
注意：自2022年起，pkg/errors 已进入维护模式，作者建议新项目评估是否使用标准库 + 显式日志记录的方式。但对于需要详细堆栈的场景，它仍是可靠选择。
基本上就这些。只要记住：要用 Wrap 加上下文，用 %+v 看堆栈，就能有效定位错误源头。
