基于 Go 1.23+ 泛型的高性能、类型安全的工具函数库
- 模块化设计: 6个专业模块,职责清晰
- Go 1.23+ 支持: 利用最新语言特性优化
- 零外部依赖: 仅依赖
golang.org/x/exp - 完全泛型化: 100% 类型安全,编译时检查
BenchmarkMapPerformance-22 850406 1670 ns/op 8192 B/op 1 allocs/op- 850K+ ops/sec 超高吞吐量
- 单次内存分配 优化策略
- 与原生 for 循环性能相当
Map[T, R]([]T, func(T, int) R) []R- 元素变换Filter[T]([]T, func(T, int) bool) []T- 条件过滤Reduce[T, R]([]T, func(R, T, int) R, R) R- 归约操作Find[T]([]T, func(T) bool) (T, bool)- 查找元素Uniq[T]([]T) []T/UniqBy[T, U]([]T, func(T) U) []T- 去重GroupBy[T, U]([]T, func(T) U) map[U][]T- 分组Chunk[T]([]T, int) [][]T- 分块处理Flatten[T]([][]T) []T- 数组展平
Union[T](...[]T) []T- 并集运算Intersection[T](...[]T) []T- 交集运算Difference[T]([]T, ...[]T) []T- 差集运算Drop[T]([]T, int) []T/DropRight[T]([]T, int) []T- 元素删除Compact[T]([]T) []T- 零值清理Partition[T]([]T, func(T) bool) ([]T, []T)- 条件分组
Keys[K, V](map[K]V) []K/Values[K, V](map[K]V) []V- 键值提取PickBy[K, V](map[K]V, func(K, V) bool) map[K]V- 条件选择OmitBy[K, V](map[K]V, func(K, V) bool) map[K]V- 条件排除MapKeys[K, V, R](map[K]V, func(K, V) R) map[R]V- 键变换MapValues[K, V, R](map[K]V, func(K, V) R) map[K]R- 值变换Invert[K, V](map[K]V) map[V]K- 键值互换
Sum[T]([]T) T/SumBy[T, R]([]T, func(T) R) R- 求和运算Mean[T]([]T) float64- 平均值计算Median[T]([]T) float64- 中位数计算Min[T]([]T) T/Max[T]([]T) T- 最值查找Clamp[T](T, T, T) T- 数值限制Range(int, int) []int- 序列生成
Must[T](T, error) T- 错误转 panicTry*系列 - 安全执行函数ToPtr[T](T) *T/FromPtr[T](*T) T- 指针操作Coalesce[T](...T) (T, bool)- 空值合并AsyncRun[T](func() T) <-chan T- 异步执行DebounceFunc/Throttle- 函数节流防抖
Ternary[T](bool, T, T) T- 三元运算符IfValue/IfFunc- 链式条件判断- 支持
ElseIf/ElseIfFunc多分支逻辑
go get github.com/phuhao00/sugar/v2@v2.0.0import "github.com/phuhao00/sugar/v2"
// 切片操作
nums := []int{1, 2, 3, 4, 5}
doubled := sugar.Map(nums, func(x int, i int) int { return x * 2 })
evens := sugar.Filter(nums, func(x int, i int) bool { return x%2 == 0 })
sum := sugar.Reduce(nums, func(acc int, x int, i int) int { return acc + x }, 0)
// 映射操作
m := map[string]int{"apple": 5, "banana": 3}
keys := sugar.Keys(m) // [apple, banana]
expensive := sugar.PickBy(m, func(k string, v int) bool { return v >= 5 })
// 实用工具
result := sugar.Ternary(len(nums) > 3, "long", "short")
value := sugar.Must(strconv.Atoi("123")) // 123
// 数学统计
avg := sugar.Mean([]float64{1, 2, 3, 4, 5}) // 3.0
clamped := sugar.Clamp(10, 1, 5) // 5| v1.x | v2.0 | 说明 |
|---|---|---|
SliceFiltrate |
Filter |
统一命名规范 |
SliceUpdateElement |
Map |
简化函数名 |
SliceUniq |
UniqBy |
功能更明确 |
FiltrateBy |
PickBy |
参考业界标准 |
- 旧版本:
github.com/phuhao00/sugar - 新版本:
github.com/phuhao00/sugar/v2⚠️ 必须更新
-
更新导入路径:
// 旧版 import "github.com/phuhao00/sugar" // 新版 import "github.com/phuhao00/sugar/v2"
-
函数调用更新:
// 旧版 result := sugar.SliceFiltrate(slice, func(v Type, i int) bool { return condition }) // 新版 result := sugar.Filter(slice, func(v Type, i int) bool { return condition })
-
升级 Go 版本要求:Go 1.23+
| 操作 | Sugar v2.0 | 原生 for | samber/lo | go-funk |
|---|---|---|---|---|
| Map 1000 元素 | 1670 ns | 1650 ns | 1750 ns | 11000+ ns |
| 内存分配 | 1 alloc | 1 alloc | 1 alloc | 3+ allocs |
| 类型安全 | ✅ 编译时 | ✅ 编译时 | ✅ 编译时 | ❌ 运行时 |
- Issue 反馈: GitHub Issues
- PR 贡献: 欢迎提交改进建议
- 文档完善: 中文文档持续优化
MIT License - 详见 LICENSE 文件
Sugar v2.0.0 - 让 Go 开发更甜蜜!🍬✨