errors.Join 是 Go 1.20+ 唯一推荐的多重错误组合方式，它构造可展开、可检查、可嵌套的错误集合，支持 errors.Is/As 递归匹配，自动忽略 nil 子错误，且不丢失原始类型信息。
errors.Join 是 Go 1.20+ 唯一推荐的多重错误组合方式
Go 1.20 引入了 errors.Join，它取代了社区此前各种自定义错误聚合方案（如 multierr、errgroup 中的手动拼接），成为标准库中唯一原生支持“多个错误同时返回”的机制。它不是字符串拼接，而是构造一个可展开、可检查、可嵌套的错误集合。
什么时候必须用 errors.Join 而不是 fmt.Errorf("%w, %w")
fmt.Errorf 的格式化写法看似能合并错误，但本质是把多个错误转成字符串再包装一层——丢失了原始错误的类型信息和底层结构，无法用 errors.Is 或 errors.As 正确识别子错误。
-
errors.Join(err1, err2, err3)返回的错误实现了Unwrap()方法，返回所有子错误切片，支持递归展开 -
errors.Is(joinedErr, targetErr)会逐层遍历整个错误树，匹配任意子错误 -
errors.As(joinedErr, &target)同样能向下穿透找到第一个匹配的子错误实例 - 若其中某个子错误为
nil，errors.Join会自动忽略，不报错也不影响其余错误
实际使用中的典型场景与写法
常见于并发任务失败汇总、多步骤清理逻辑、HTTP 多部分响应校验等需要“不丢错误、不掩盖细节”的场合。
func cleanupResources() error {
var errs []error
if err := closeDB(); err != nil {
errs = append(errs, err)
}
if err := shutdownCache(); err != nil {
errs = append(errs, err)
}
if err := flushLogs(); err != nil {
errs = append(errs, err)
}
if len(errs) == 0 {
return nil
}
return errors.Join(errs...)
}
注意：errors.Join 接收可变参数，传入空切片（errors.Join([]error{}...)）会返回 nil；但直接传 nil 切片（如 errors.Join(errs...) 当 errs 为 nil）会 panic，务必先判空或用 len(errs) > 0 守护。
立即学习“go语言免费学习笔记（深入）”；
嵌套 Join 与调试时容易忽略的细节
errors.Join 支持嵌套：你可以把一个已 Join 过的错误再作为参数传入，它会扁平化展开（不是套娃）。但调试输出时默认只显示顶层结构，需手动调用 errors.Unwrap 或使用第三方工具（如 go-errors 的树形打印）才能看清全貌。
- 日志中直接
fmt.Printf("%+v", err)只显示第一层摘要，看不出具体哪些子错误触发了失败 - 用
errors.Unwrap(err)得到[]error，可遍历打印每个子错误的完整栈（如果它们本身带栈） - 不要在
Join中混入非错误值（比如errors.Join(err, "string")）——编译不过，因为参数类型严格限定为error
真正难处理的不是怎么调用 errors.Join，而是后续所有错误检查逻辑是否适配了“可能返回 Join 错误”这一事实——比如旧代码里只做 if err != nil { log.Fatal(err) }，现在得考虑是否要展开分析。
