Go 中实现类型安全的错误捕获闭包：替代泛型函数的惯用方案

go 1.18 前不支持用户自定义泛型函数，无法直接编写 `catcherror[t]` 这类参数化函数；但可通过方法接收者模式 + 类型特化方法，在保持编译期类型检查的前提下，优雅处理多类型解析与错误收集。

在 Go 中，由于语言层面长期缺乏对用户定义泛型函数的支持（直到 Go 1.18 引入泛型），你无法像 Rust 或 TypeScript 那样声明一个通用的 func catchError[T](val T, err error) T。尝试使用 interface{} 虽可绕过编译限制，但会丢失类型信息，迫使调用方进行运行时类型断言——这不仅破坏类型安全（错误仅在运行时暴露），也违背 Go “明确优于隐式”的设计哲学。

✅ 推荐惯用解法：基于接收者的方法集（Receiver-based Method Set）
将错误收集状态（如 []error）封装为结构体，并为常用类型提供显式、类型专属的方法。这种方式完全保留编译期类型检查，零反射、零 interface{}、零运行时 panic 风险：

type ErrorCollector []error

// AddIfNotNil 将非 nil 错误追加到收集器中
func (ec *ErrorCollector) AddIfNotNil(err error) {
    if err != nil {
        *ec = append(*ec, err)
    }
}

// Int 安全返回 int 值，并自动注册错误（编译期确保返回类型为 int）
func (ec *ErrorCollector) Int(val int, err error) int {
    ec.AddIfNotNil(err)
    return val
}

// Float64 同理，类型严格绑定
func (ec *ErrorCollector) Float64(val float64, err error) float64 {
    ec.AddIfNotNil(err)
    return val
}

// Struct 支持任意命名结构体（需导出字段）
func (ec *ErrorCollector) Location(val Location, err error) Location {
    ec.AddIfNotNil(err)
    return val
}

使用时清晰、类型安全、无隐式转换：

var errors ErrorCollector

data := MyStruct{
    Age:              errors.Int(parseAndValidateAge("5")),           // ✅ 返回 int，编译器校验字段类型
    DistanceFromHome: errors.Float64(parseAndValidatePi("3.14")),   // ✅ 返回 float64
    Location:         errors.Location(parseAndValidateLocation("3.14,2.0")), // ✅ 返回 Location
}

if len(errors) > 0 {
    log.Printf("Validation failed with %d errors: %+v", len(errors), errors)
    // 处理表单错误响应（如 HTTP 400 + JSON 错误详情）
}

? 为什么这是更“Go 风格”的方案？

• ✅ 类型安全：每个方法签名明确指定输入/输出类型，编译器全程校验；
• ✅ 零运行时开销：无反射、无类型断言、无接口动态调度；
• ✅ 可读性强：调用意图一目了然（errors.Int(...) 比 catchError(...).(int) 更直观）；
• ✅ 可扩展性好：新增类型只需添加对应方法（如 Bool, Time, CustomType），不破坏现有逻辑；
• ✅ 符合 Go 的组合哲学：通过结构体聚合状态 + 方法封装行为，而非依赖抽象语法糖。

⚠️ 注意事项：

• 若已升级至 Go 1.18+，可改用泛型函数提升复用性（见下文备选方案）；
• 所有 parseAndValidateX 函数必须返回 (T, error) 形式，确保与 ErrorCollector 方法签名兼容；
• ErrorCollector 应作为局部变量或请求上下文的一部分传递，避免全局/共享状态引发并发问题。

? Go 1.18+ 泛型进阶（可选）
若项目已迁移到 Go 1.18 或更高版本，可结合泛型简化重复方法定义：

func (ec *ErrorCollector) Capture[T any](val T, err error) T {
    ec.AddIfNotNil(err)
    return val
}
// 使用：Age: errors.Capture(parseAndValidateAge("5"))

但需注意：泛型版 Capture 对所有类型共用同一方法，丧失了类型语义提示（如 Int 比 Capture 更具可读性）。因此，在关键业务路径中，仍推荐显式命名方法（Int, Float64, Location）以增强代码自文档性。

总结：Go 的类型系统鼓励“明确性”而非“灵活性”。放弃幻想中的“万能 catchError”，转而拥抱接收者方法 + 类型专属接口，才是兼顾安全性、可维护性与 Go 惯用法的最佳实践。