Go / 系统课时
用泛型函数与方法复用逻辑
用泛型函数与方法复用逻辑
泛型适合消除“算法相同、数据类型不同”的重复代码。本篇用一个可运行示例同时演示类型参数、类型约束、类型推断,以及 Go 1.27 新增的泛型方法,并说明什么时候应保留普通函数或接口。
学习目标
- 能为函数声明类型参数,并用类型集合限制允许的实参类型。
- 能在 Go 1.27+ 为具体类型声明带独立类型参数的方法。
- 能判断泛型函数、泛型方法和普通接口各自适合的复用边界。
从重复函数抽出类型参数
如果 SumInts、SumInt64s、SumFloat64s 的循环完全相同,只是元素类型不同,就适合把类型变成参数。约束决定泛型代码里允许执行哪些操作;要使用 +,约束必须明确包含支持加法的类型,单写 any 不够。
下面的 Number 使用 ~int | ~int64 | ~float64。前缀 ~ 允许底层类型相同的自定义类型也满足约束,例如 type Score int。
package main
import "fmt"
type Number interface {
~int | ~int64 | ~float64
}
func Sum[T Number](values []T) T {
var total T
for _, v := range values {
total += v
}
return total
}
type Box[T any] struct {
Value T
}
// Go 1.27+:方法可以声明自己的类型参数 U。
func (b Box[T]) Map[U any](f func(T) U) Box[U] {
return Box[U]{Value: f(b.Value)}
}
func main() {
fmt.Println(Sum([]int{3, 5, 8}))
b := Box[int]{Value: 21}
mapped := b.Map(func(v int) string {
return fmt.Sprintf("id-%d", v)
})
fmt.Println(mapped.Value)
}预期输出(使用 Go 1.27+ 执行 go run main.go):
16
id-21这里调用 Sum([]int{...}) 时不必显式写 Sum[int],编译器可从实参推断 T=int。如果推断信息不足,仍可显式实例化,例如 Sum[int64](values)。
用泛型方法把转换逻辑放回类型旁边
Go 1.27 允许具体方法声明自己的类型参数,因此 Box[T] 的接收者类型参数 T 与方法参数 U 可以同时存在。Map 接收 func(T) U,所以 Box[int] 可以自然转换为 Box[string],不必为每种目标类型声明 MapString、MapFloat64 等方法。
泛型函数与泛型方法的选择可以按调用语义判断:
| 形式 | 更适合的情况 | 示例 |
|---|---|---|
| 泛型函数 | 算法不属于某个接收者,输入可来自多种容器 | Sum[T Number]([]T) |
| 泛型方法 | 操作天然属于某个具体类型,且希望链式或点号调用 | box.Map(...) |
| 普通方法 | 输入和输出类型固定,没有跨类型复用需求 | file.Close() |
如果项目仍需兼容 Go 1.26 或更早版本,方法不能声明自己的类型参数,应继续写包级泛型函数,例如 MapBox[T, U any](Box[T], func(T) U) Box[U]。
让约束只表达真正需要的能力
约束越宽,函数越通用;但宽到 any 后,编译器也只能保证最少能力。比如 comparable 只保证可使用 == 和 !=,并不保证支持 <、> 或 +。
设计约束时可以按代码实际操作反推:
- 只存取和返回值:使用
any。 - 需要 map 键或相等比较:使用
comparable。 - 需要算术:用明确的类型集合,例如本例的
Number。 - 需要调用方法:定义包含相应方法的接口约束。
不要为了“以后可能用到”一次加入十几种类型。公共约束越复杂,后续修改越容易影响调用方;先覆盖真实需求,再根据编译期错误扩展类型集合更稳妥。
认识泛型方法的接口边界
Go 1.27 的泛型方法是具体类型的方法能力,不等于“泛型接口方法”。接口中的方法不能声明自己的类型参数,泛型方法也不能拿来实现接口方法。因此,当调用方需要通过接口替换实现时,应把接口设计成非泛型方法,或把类型参数放到包级泛型函数上。
例如“把任意 T 转成任意 U”更适合具体容器上的泛型 Map;而“任何存储都必须提供 Close() error”仍应使用普通接口方法。判断标准很直接:如果复用目标是编译期类型变换,泛型通常合适;如果复用目标是运行时替换不同实现,接口通常更合适。