SuperAPI AI 工具集

golang-samber-mo

编程与开发

查看项目

更新于 10-16 09:55

技能介绍

用途:为 Go 引入函数式编程安全,用单子类型让“不可能状态”不可表示——nil 检查变为类型约束,错误处理变为可组合流水线。库受 Scala、Rust、fp-ts 启发,零依赖。

主要能力:Option[T] 表示可能缺失的值(Some/None),消除 nil 风险,实现 json.Marshaler/Unmarshaler、sql.Scanner、driver.Valuer,可直接用于 JSON 结构体与数据库模型;Result[T] 表示成功或失败,替代 (T, error);Either[L,R] 表示二选一的合法值(Either3/4/5 支持更多变体);另有 Future[T](异步值)、IO[T](惰性同步副作用)、Task[T](惰性异步计算)、State[S,A](有状态计算)。

使用方式:安装命令为 go get github.com/samber/mo。同类型转换用直接方法 .Map/.FlatMap;跨类型转换需用子包函数(如 option.Map、result.Map)配合 Pipe3 等管道函数。mo.Do 可把命令式代码包进 Result 并捕获 MustGet 的 panic。mo.Fold 通过 Foldable 接口统一处理 Option、Result、Either。

适用场景:JSON API 响应中的可空字段、数据库可空列、在 API 边界把 Go 的 (T, error) 转成 Result 后链式处理、缓存与实时数据等两种合法分支的建模。

限制与注意事项:Go 方法无法引入新类型参数,Result[T].Map 仍返回 Result[T],类型变更须用子包函数或 mo.Do;MustGet 在 None/Err 时 panic,仅在 mo.Do 内或确定存在时使用;Option[string] 区分“缺失”与“空字符串”,空字符串为合法值时应用普通 string。官方资源见 pkg.go.dev/github.com/samber/mo 与 github.com/samber/mo。