Samber Lo Go 函数式工具库
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/samber-cc-skills-golang-golang-samber-lo。
技能介绍
问题:标准库盖不住的那类集合逻辑
Go 1.21 之后 slices / maps 能处理排序、Contains、键迭代等少数操作,但 Map、Filter、Reduce、GroupBy、Chunk、Flatten、Zip 仍要自己写 for 循环,还容易在泛型里踩 interface{} 或反射。github.com/samber/lo 用 generics-first 的方式补齐这层:编译期类型检查、默认返回新集合(不可变)、函数输入输出都是 slice/map,便于链式组合。
技能覆盖的核心能力
本技能指导你在工程里如何 选对包、写对模式:
- 默认用
lo:日常lo.Map/lo.Filter/lo.Reduce/lo.GroupBy等,替代多层嵌套循环。 - 错误短路:优先
MapErr、FilterErr、ReduceErr,在第一次错误处停止,而不是手写错误收集。 - 按需升级:
lop面向 CPU 密集、大数据量并行;lom仅在pprof证实分配压力后做原地变更;loi(Go 1.23+)用惰性迭代减少链式中间的临时 slice;I/O 扇出仍应用errgroup,而不是误用lop。 - 与生态衔接:包文档与符号事实可对照
golang-pkg-go-dev;代码导航用gopls;无限流式管线另见samber/ro。
边界与常见坑
有标准库能力时先用标准库(如 slices.Contains、slices.Collect(maps.Keys(m)))。不要用 lop 处理十来条数据的 Map;不要把 lo.Filter 当成原地修改;生产路径避免 lo.Must。大体积链式变换先量测再决定 loi 或 lom。
使用场景
- HTTP 层要把上游 DTO 切片按业务规则过滤并映射成响应结构,用 `lo.Filter` 与 `lo.Map` 替代嵌套 for
- 批量导入 CSV 行时在 `MapErr` 里解析字段,遇首个格式错误即中断并向上返回
- 多租户配置列表需要按 `tenant_id` 分组下发,用 `lo.GroupBy` 一次性产出 map 而非手写双层循环
- pprof 显示大 slice 链式 Map→Filter→Take 分配过多,评估改用 `loi` 惰性迭代削减中间切片
适合人员
- 维护 Gin/Echo 等服务的后端 Go 工程师,经常在 handler 里对 slice 做过滤、映射与聚合
- 写内部 SDK 的库作者,希望用泛型工具替代反射实现 Map/Reduce 类 API
- 做过性能调优的工程师,需要在 `lo`、`lom`、`lop` 之间按 pprof 结果做有依据的切换
- 数据管道开发者在批处理任务里用 `ReduceErr`/`MapErr` 统一错误短路语义