应使用 fmt.Errorf 的 %w 动词包装错误以保留错误链，支持 errors.Is 和 errors.Unwrap；避免用 %s 或 %v 拼接，否则切断链；原生 fmt 不处理堆栈，%+v 无效，需第三方库或手动注入。
直接用 fmt.Printf 或 fmt.Println 打印错误值，通常只显示错误文本，丢失堆栈和上下文；真要调试或生产日志，得用 fmt.Errorf 构造带上下文的错误，再配合 %+v（需第三方库）或 errors.Is/errors.As 做判断——但原生 fmt 包本身不处理堆栈。
用 fmt.Errorf 包裹错误并添加上下文
Go 1.13+ 推荐用 fmt.Errorf 的 %w 动词包装底层错误，这样能保留原始错误链，支持 errors.Unwrap 和 errors.Is。
常见错误是写成 fmt.Errorf("failed: %s", err) ——这会把 err.Error() 转成字符串，切断错误链。
- ✅ 正确：用
%w包装：fmt.Errorf("reading config: %w", err) - ❌ 错误：用
%s或%v拼接：fmt.Errorf("reading config: %s", err) - ⚠️ 注意：
%w只接受单个error类型参数，不能跟其他值混用，否则编译报错cannot use %w verb with non-error type
fmt.Print* 系列函数对 error 类型的默认行为
fmt.Println、fmt.Printf("%v")、fmt.Printf("%s") 对 error 值的输出效果不同，容易混淆：
立即学习“go语言免费学习笔记（深入）”；
-
fmt.Println(err)和fmt.Printf("%v", err)→ 调用err.Error()，只输出错误消息字符串 -
fmt.Printf("%s", err)→ 编译失败！err不是string，不能直接当字符串格式化 -
fmt.Printf("%q", err)→ 输出带引号的err.Error()字符串（如"no such file"），一般不用 - 想看错误类型名？用
fmt.Printf("%T", err)，例如*os.PathError
为什么 fmt.Printf("%+v", err) 有时没堆栈？
因为原生 fmt 包的 %+v 对标准 error 接口不做特殊处理——它只对结构体字段加标签打印，而大多数错误（如 os.Open 返回的）是封装的结构体，但默认不导出内部字段，也不自动注入堆栈。
真正能打印堆栈的，是第三方包（如 github.com/pkg/errors 或 Go 1.17+ 的 debug.PrintStack() 配合自定义错误）。
- 如果你用了
github.com/pkg/errors.Wrap，那fmt.Printf("%+v", err)才会显示文件/行号 -
标准库中只有
fmt.Errorf（带%w）+errors.Is这条链是官方推荐路径，不带堆栈 - 调试时临时加堆栈？可手动在错误前插入：
fmt.Printf("at %s: %+v\n", debug.CallersFrames(debug.Callers(2)).Next().Function, err)，但别放生产代码里
错误格式化的关键不在“怎么打印得好看”，而在“怎么构造得可查”——%w 是分水岭，漏掉它，上游就再也 errors.Is 不到原始错误了。
