Go 中实现类型安全的错误捕获与值透传：使用泛型前的惯用方案

在 go 1.18 之前，无法为用户函数定义真正泛型的 `catcherror`；本文介绍兼容旧版本的类型安全实践——通过方法接收者重载模拟泛型行为，并对比 `interface{}` 方案的取舍。

Go 的类型系统强调显式性与编译期安全性，但早期版本（Go 1.18 之前）不支持用户自定义函数的参数化多态（即泛型函数），因此无法直接写出形如 func catchError[T any](val T, err error) T 的通用错误处理闭包。试图用单一函数统一处理 int、float64、自定义结构体等不同返回类型的解析结果，在语言层面不可行。

最直观的“通解”是退回到 interface{}：

func catchError(val interface{}, err error) interface{} {
    if err != nil {
        errors = append(errors, err)
    }
    return val
}

// 调用时需强制类型断言，失去编译期类型保障：
Age:   catchError(parseAndValidateAge("5")).(int),
Location: catchError(parseAndValidateLocation("3.14,2.0")).(Location),

⚠️ 这种方式虽能运行，但牺牲了关键优势：编译期类型检查。若 parseAndValidateLocation 实际返回 string，而你误写 . (Location)，程序将在运行时 panic，违背 Go “fail fast at compile time” 的设计哲学。

更符合 Go 惯用法（idiomatic）且保持类型安全的方案，是将错误收集逻辑封装为结构体方法，并为常用类型提供显式重载方法：

type ErrorList []error

func (e *ErrorList) Add(err error) {
    if err != nil {
        *e = append(*e, err)
    }
}

// 类型专属方法：每个方法签名明确，编译器全程校验
func (e *ErrorList) Int(v int, err error) int     { e.Add(err); return v }
func (e *ErrorList) Float64(v float64, err error) float64 { e.Add(err); return v }
func (e *ErrorList) Location(v Location, err error) Location { e.Add(err); return v }

// 使用示例（完全类型安全，零运行时断言）
var errors ErrorList
data := MyStruct{
    Age:              errors.Int(parseAndValidateAge("5")),
    DistanceFromHome: errors.Float64(parseAndValidatePi("3.14")),
    Location:         errors.Location(parseAndValidateLocation("3.14,2.0")),
}

if len(errors) > 0 {
    // 统一处理所有解析错误
    log.Fatal("Validation failed:", errors)
}

✅ 优势总结：

• 100% 编译期类型安全：每个方法只接受特定类型，调用时若类型不匹配（如把 string 传给 .Int()），编译直接报错；
• 零反射、零 unsafe、零接口断言：性能无损耗，语义清晰；
• 符合 Go 的显式哲学：不隐藏类型转换，错误收集与值透传逻辑内聚于同一接收者；
• 可扩展性强：新增类型只需添加对应方法（如 Bool()、CustomType()），IDE 可自动补全。

? 提示：若项目已升级至 Go 1.18+，推荐直接使用泛型重构该模式，代码更简洁且 DRY：

func Catch[T any](val T, err error, errs *[]error) T {
    if err != nil {
        *errs = append(*errs, err)
    }
    return val
}
// 使用：Age: Catch(parseAndValidateAge("5"), &errors)

但对存量 Go 1.17 及更早项目，上述 ErrorList 方法重载方案仍是兼顾安全性、可读性与工程稳健性的最佳实践。