go 不该用泛型 result[t, e] 替代 error 接口,因其破坏 errors.is/as 兼容性、ide 跳转、staticcheck 检查,且需反复解包、不支持类型推导、defer 无法捕获 .must() panic;应优先用结构体如 parseresult{value int, err error} 复用原生错误能力。

Go 里不该用泛型 Result[T, E] 替代 error 接口,它不解决实际问题,反而破坏生态兼容性、IDE 支持和错误分类能力。
为什么 Result 泛型在 Go 中水土不服
Go 的错误处理不是缺陷,而是与多返回值、defer、包导入约束深度绑定的设计选择。强行引入 Rust 风格的 Result[T, E] 会带来明显副作用:
-
errors.Is和errors.As对自定义Result类型基本失效——IDE 跳不到原始错误定义,staticcheck报告大量误报 - 调用链中必须反复
.Unwrap()或.Must()才能喂给标准库函数(比如json.Marshal(r.Must())),最终还是得解包成val, err := f() - Go 1.22+ 不支持类型推导:你不能写
foo(Ok(42)),必须写全foo(Result[int, error]{...}),冗长且无收益 -
defer和recover捕获不了.Must()触发的 panic,线上出错直接 crash,无法兜底
真正需要“成功/失败”语义时,怎么轻量表达
不靠泛型,也能清晰区分分支意图,关键是复用 Go 原生错误能力:
定义一个结构体,字段名用 Err(不是 Error),保持与 json.Unmarshal 等标准行为一致:
type ParseResult struct {
Value int
Err error
}
func (r ParseResult) IsOk() bool { return r.Err == nil }
func (r ParseResult) Unwrap() int {
if r.Err != nil {
panic(r.Err)
}
return r.Value
}
这样既保留 errors.Is(err, fs.ErrNotExist) 的能力,又可通过 r.IsOk() 快速判断,不引入新依赖。
注意:别实现 Unwrap() 方法——它会被 errors.Unwrap() 递归调用,导致无限循环;也别让字段叫 Error,JSON 序列化时容易和标准 error 字段混淆。
HTTP handler 里怎么用才不翻车
不要让 handler 返回 Result[Response],这会逼你在中间件里写胶水代码去解包,破坏 net/http 生态:
- 把
Result限制在业务逻辑层(如配置解析、CLI 参数校验等封闭子系统) - handler 层只做一次转换:
if r.IsOk() { json.NewEncoder(w).Encode(r.Must()) } else { http.Error(w, r.Err.Error(), http.StatusBadRequest) } - 切忌在中间件里自动解包
Result——它不是上下文,也不是请求生命周期的一部分,强行注入只会让错误流不可控
泛型 Result 在 Go 里唯一不可替代的场景,是封装「非 error 类失败原因」且需静态检查,比如 HTTP 客户端要区分 404(资源不存在)和 503(服务不可用),这两个都不该塞进 error,而应定义 HttpResult[T] 并带 Code int 字段。但这种情况极少,95% 的项目用好 error + 结构化包装就够了。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











