Go语言中通过%w包装错误并逐层添加上下文，结合errors.Unwrap实现错误链追踪，使用fmt.Errorf("context: %w", err)保留原始错误，可手动遍历Unwrap输出调用链；若需堆栈信息，推荐使用github.com/pkg/errors的WithStack或Wrap函数，配合%+v打印详细调用路径，从而实现完整的错误溯源与调试。
在Go语言中实现错误链记录与追踪，关键在于保留原始错误信息的同时添加上下文，以便在发生错误时能清晰地回溯调用路径。从Go 1.13开始，标准库引入了对错误包装（error wrapping）的支持，使得构建可追溯的错误链成为可能。
使用 errors.Wrap 和 %w 格式动词
Go 1.13+ 支持通过 %w 动词包装错误，被包装的错误可以通过 errors.Unwrap 提取。这是构建错误链的基础。
示例：
if err != nil {
return fmt.Errorf("failed to read config: %w", err)
}
这样，新错误保留了原错误，并可通过 errors.Is 和 errors.As 进行判断和类型断言。
立即学习“go语言免费学习笔记（深入）”；
逐层添加上下文形成调用链
在每一层函数调用中，适当地包装错误并附加上下文，可以形成完整的错误路径。
例如：
func loadConfig() error {
_, err := os.Open("config.json")
if err != nil {
return fmt.Errorf("opening config file: %w", err)
}
return nil
}
func runApp() error {
if err := loadConfig(); err != nil {
return fmt.Errorf("initializing app: %w", err)
}
return nil
}
当错误发生时，调用栈信息逐步叠加，最终可通过递归 Unwrap 或使用 %+v（若使用第三方库如 pkg/errors）查看完整链条。
打印错误链与调试追踪
要输出完整的错误链，可以手动遍历 Unwrap 结果：
var err error = fmt.Errorf("step3: %w", fmt.Errorf("step2: %w", fmt.Errorf("step1")))
for e := err; e != nil; e = errors.Unwrap(e) {
fmt.Println(e)
}
输出为：
step3: step2: step1 step2: step1 step1
这有助于定位错误源头。注意标准库不支持堆栈追踪，若需文件名和行号，可考虑使用 github.com/pkg/errors，它提供 errors.WithStack 自动记录调用栈。
使用 pkg/errors 增强追踪能力
该库扩展了标准 errors 包，支持自动堆栈捕获和 %+v 格式输出完整调用链。
示例：
import "github.com/pkg/errors" // 包装时自动记录栈 err = errors.WithStack(err) // 或直接添加上下文 return errors.Wrap(err, "read failed")
用 fmt.Printf("%+v\n", err) 可打印带堆栈的详细信息，极大提升排查效率。
基本上就这些。标准库已能满足基本错误链需求，若项目需要精细追踪，引入 pkg/errors 是常见选择。关键是每一层都合理包装，不丢失原始错误。
