Go 1.13+ 的 fmt.Errorf 包装为什么总丢参数？
因为默认用 %w 包装时，原始错误的字段（比如自定义结构体里的 StatusCode、RetryAfter）不会自动透出——%w 只保留底层错误链，不合并字段。你看到的 errors.Is 或 errors.As 能查到类型，但拿不到具体值。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
fmt.Errorf("api failed: %w", err)仅用于记录上下文，别指望它带出参数 - 若需传递参数，必须显式构造新错误类型，或在包装时把关键字段作为额外参数传入
- 避免对
net/http错误等标准库错误直接%w包装后还试图取err.StatusCode——它没这个字段
怎么写一个能带参数又支持 errors.As 的自定义错误？
核心是实现 Unwrap() 和自定义字段，再让 errors.As 能匹配到你的结构体。不是加个字段就行，得让 Go 的错误反射机制认得出来。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 字段必须是导出的（首字母大写），否则
errors.As拿不到值 -
Unwrap()方法返回error类型字段（通常是cause error），不能返回nil除非是叶子错误 - 别在
Error()方法里拼接所有参数——日志里会重复，且不利于结构化解析
示例：
type APIError struct {
StatusCode int
Message string
cause error
}
func (e *APIError) Error() string { return e.Message }
func (e *APIError) Unwrap() error { return e.cause }
func (e *APIError) Is(target error) bool {
_, ok := target.(*APIError)
return ok
}
errors.Join 能不能用来聚合多个带参错误？
不能。它只合并错误文本和链路，不保留任何结构化字段。调用 errors.As(err, &e) 在 Join 后的结果上永远失败。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 需要聚合多错误 + 保参数？自己写一个容器类型，比如
MultiAPIError，含切片字段和自定义Unwrap() - 如果只是想“记录多个错误”，用
fmt.Sprintf拼字符串更直白，别硬套Join -
Join适合临时组合几个无关的底层错误（如关闭多个文件时的 err），不适合业务错误建模
日志中打印带参错误时，为什么 %+v 不显示字段？
因为默认格式化器不递归展开错误链里的字段，只调 Error() 方法。即使你用了自定义错误，%+v 也看不到 StatusCode 这类字段。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 调试时用
fmt.Printf("%#v", err)，它会显示结构体字面量，包括未导出字段（但生产环境慎用） - 生产日志中，显式提取关键字段：比如
log.Printf("api error: code=%d msg=%q cause=%v", apiErr.StatusCode, apiErr.Message, apiErr.cause) - 别依赖日志库的自动结构化（如
zerolog.Error().Err(err)）来捕获自定义字段——它只认标准 error 接口
errors.As 显式提供类型匹配逻辑，Go 不会自动推导。 
