go不支持多异常抛出，需用errors.join聚合错误（go1.20+）、手动收集错误切片分类处理，或借助multierr库；错误链仅适用于单向嵌套，不适用于并列错误。
Go 语言原生不支持“抛出多个错误”或“嵌套异常”，error 是接口，单次返回只能是一个值；想“捕获并处理多个错误”，本质是**聚合、分类、延迟判断或组合上报**，不是 try-catch 多 catch 块那种逻辑。
用 errors.Join 合并多个 error（Go 1.20+）
当你在循环或并行操作中积累多个独立错误（比如批量写文件、并发请求），需要统一返回而非提前中断时，errors.Join 是最直接的方式。它返回一个实现了 error 接口的组合错误，调用 Error() 会拼接所有子错误信息。
注意：errors.Join 忽略 nil，且结果不可逆向拆解 —— 它只适合“最终上报”，不适合后续分支处理。
- 如果任一子错误为
nil，会被自动跳过 - 返回的 error 不支持类型断言还原原始错误（除非你自己封装）
- 不要用它替代业务逻辑判断：比如“3 个请求失败了 2 个”，应单独计数，不能只依赖
errors.Join的字符串输出
err := errors.Join(
os.WriteFile("a.txt", []byte("1"), 0644),
os.WriteFile("b.txt", []byte("2"), 0644),
os.WriteFile("c.txt", []byte("3"), 0644),
)
if err != nil {
log.Println("批量写入失败：", err) // 输出类似 "2 errors occurred: ...; ..."
}
手动构建错误切片 + 自定义 error 类型
当你要对多个错误做差异化处理（比如重试部分、忽略特定码、统计失败率），就不能只靠 errors.Join。更可控的做法是收集 []error，再根据业务规则决策。
立即学习“go语言免费学习笔记（深入）”；
常见场景：HTTP 批量调用后，需区分 404（跳过）、500（重试）、超时（告警）。
- 避免直接用
fmt.Errorf("%w; %w", a, b)拼接 —— 这会丢失堆栈和原始类型信息 - 若需保留每个错误的上下文，可定义结构体如
type BatchError struct { Op string; Err error; Index int } - 检查是否含某类错误时，用
errors.Is(err, target)或errors.As(err, &target)对组合 error 无效，必须作用于原始项
var errs []error
for i, url := range urls {
if resp, err := http.Get(url); err != nil {
errs = append(errs, fmt.Errorf("fetch[%d] %s: %w", i, url, err))
}
}
// 后续可遍历 errs 单独分析
使用 multierr 库（兼容老版本 Go）
Go 1.20 前没有 errors.Join，社区广泛使用 go.uber.org/multierr。它的行为更灵活：支持追加、过滤、折叠，并保留第一个非-nil 错误作为“主错误”（可用于 errors.Is 判断）。
但要注意：它默认不导出内部错误列表，若需遍历仍得用 multierr.Errors(err) 解包。
-
multierr.Append(a, b)类似errors.Join，但返回 error 中第一个非-nil 项可被errors.Is匹配 - 若你依赖
errors.Is(err, fs.ErrNotExist)判断组合错误是否含某个底层错误，multierr默认不支持，需手动解包 - 引入第三方库会增加依赖链，纯标准库项目慎用
别把“多个错误”和“错误链”混淆
Go 的错误链（%w 包装）是单向嵌套，用于表达“因为 A 所以 B”，不是并列关系。多个错误并列时，错误链模型天然不适用 —— 你不能用 fmt.Errorf("failed: %w and %w", err1, err2)，语法不合法。
真正需要并列语义时，必须显式选择聚合方式（切片、Join、自定义结构），而不是试图用链式包装模拟。
最容易被忽略的一点：日志记录多个错误时，别只打 err.Error() —— 它可能只显示第一个或摘要，丢失细节；应遍历原始错误集合，逐条记录带上下文的完整信息。
