『每周译Go』Go官方出品：如何使用泛型

备注：这是一个 beta 版本的内容

这个教程介绍了 Go 泛型的基础概念。通过泛型，你可以声明并使用函数或者是类型，那些用于调用代码时参数需要兼容多个不同类型的情况。

在这个教程里，你会声明两个普通的函数，然后复制一份相同的逻辑到一个泛型的方法里。

你会通过以下几个章节来进行学习：

1. 为你的代码创建一个文件夹；
2. 添加非泛型函数；
3. 添加一个泛型函数来处理多种类型；
4. 在调用泛型函数时删除类型参数；
5. 声明一个类型约束。

备注：对其他教程，可以查看教程 备注：你同时也可以使用 "Go dev branch"模式来编辑和运行你的代码，如果你更喜欢以这种形式的话

• 安装 Go 1.18 Beta 1 或者更新的版本。对安装流程，请看安装并使用 beta 版本。
• 代码编辑器。任何你顺手的代码编辑器。
• 一个命令终端。Go 在任何终端工具上都很好使用，比如 Linux 、Mac、PowerShell 或者 Windows 上的 cmd。

安装并使用 beta 版本

这个教程需要 Beta 1 的泛型特性。安装 beta 版本，需要通过下面几个步骤：

1、 执行下面的指令安装 beta 版本

$ go install golang.org/dl/go1.18beta1@latest

2、 执行下面的指令下载更新

$ go1.18beta1 download

3、用 beta 版本执行 go 命令，而不是 Go 的发布版本 (如果你本地有安装的话)

你可以使用 beta 版本名称或者把 beta 重命名成别的名称来执行命令。

• 使用 beta 版本名称，你可以通过 go1.18beta1 来执行指令而不是 go：

$ go1.18beta1 version

• 通过对 beta 版本名称重命名，你可以简化指令：

$ alias go=go1.18beta1
$ go version

在这个教程中将假设你已经对 beta 版本名称进行了重命名。

在一开始，先给你要写的代码创建一个文件夹

1、 打开一个命令提示符并切换到/home 文件夹

在 Linux 或者 Mac 上：

$ cd

在 windows 上：

C:\> cd %HOMEPATH%

在接下去的教程里面会用$来代表提示符。指令在 windows 上也适用。

2、 在命令提示符下，为你的代码创建一个名为 generics 的目录

$ mkdir generics
$ cd generics

3、 创建一个 module 来存放你的代码

执行go mod init指令，参数为你新代码的 module 路径

$ go mod init example/generics
go: creating new go.mod: module example/generics

备注：对生产环境，你会指定一个更符合你自己需求的 module 路径。更多的请看依赖管理

接下来，你会增加一些简单的和 maps 相关的代码。

在这一步中，你将添加两个函数，每个函数都会累加 map 中的值 ，并返回总和。

你将声明两个函数而不是一个，因为你要处理两种不同类型的 map：一个存储 int64 类型的值，另一个存储 float64 类型的值。

写代码

1、 用你的文本编辑器，在 generics 文件夹里面创建一个叫 main.go 的文件。你将会在这个文件内写你的 Go 代码。

2、 到 main.go 文件的上方，粘贴如下的包的声明。

package main

一个独立的程序（相对于一个库）总是在 main 包中。

3、 在包的声明下面，粘贴以下两个函数的声明。

// SumInts adds together the values of m.
func SumInts(m map[string]int64) int64 {
    var s int64
    for _, v := range m {
        s += v
    }
    return s
}

// SumFloats adds together the values of m.
func SumFloats(m map[string]float64) float64 {
    var s float64
    for _, v := range m {
        s += v
    }
    return s
}

在这段代码中，你：

• 声明两个函数，将一个 map 的值加在一起，并返回总和。
• SumFloats 接收一个 map，key 为 string 类型，value 为 floa64 类型。
• SumInt 接收一个 map，key 为 string 类型，value 为 int64 类型。

4、 在 main.go 的顶部，包声明的下面，粘贴以下 main 函数，用来初始化两个 map，并在调用你在上一步中声明的函数时将它们作为参数。

func main() {
// Initialize a map for the integer values
ints := map[string]int64{
    "first": 34,
    "second": 12,
}

// Initialize a map for the float values
floats := map[string]float64{
    "first": 35.98,
    "second": 26.99,
}

fmt.Printf("Non-Generic Sums: %v and %v\n",
    SumInts(ints),
    SumFloats(floats))
}

在这段代码中，你：

• 初始化一个 key 为 string，value 为float64的 map 和一个 key 为 string，value 为int64的 map，各有 2 条数据；
• 调用之前声明的两个方法来获取每个 map 的值的总和；
• 打印结果。

5、 靠近 main.go 顶部，仅在包声明的下方，导入你刚刚写的代码所需要引用的包。

第一行代码应该看起来如下所示：

package main
import "fmt"

6、 保存 main.go.

运行代码

在 main.go 所在目录下，通过命令行运行代码

$ go run .
Non-Generic Sums: 46 and 62.97

有了泛型，你可以只写一个函数而不是两个。接下来，你将为 maps 添加一个泛型函数，来允许接收整数类型或者是浮点数类型。

在这一节，你将会添加一个泛型函数来接收一个 map，可能值是整数类型或者浮点数类型的 map，有效地用一个函数替换掉你刚才写的 2 个函数。

为了支持不同类型的值，这个函数需要有一个方法来声明它所支持的类型。另一方面，调用代码将需要一种方法来指定它是用整数还是浮点数来调用。

为了实现上面的描述，你将会声明一个除了有普通函数参数，还有类型参数的函数。这个类型参数实现了函数的通用性，使得它可以处理多个不同的类型。你将会用类型参数和普通函数参数来调用这个泛型函数。

每个类型参数都有一个类型约束，类似于每个类型参数的 meta-type。每个类型约束都指定了调用代码时每个对应输入参数的可允许的类型。

虽然类型参数的约束通常代表某些类型，但是在编译的时候类型参数只代表一个类型 - 在调用代码时作为类型参数。如果类型参数的类型不被类型参数的约束所允许，代码则无法编译。

需要记住的是类型参数必须满足泛型代码对它的所有的操作。举个例子，如果你的代码尝试去做一些 string 的操作 (比如索引)，而这个类型参数包含数字的类型，那代码是无法编译的。

在下面你要编写的代码里，你会使用允许整数或者浮点数类型的限制。

写代码

1、 在你之前写的两个函数的下方，粘贴下面的泛型函数

// SumIntsOrFloats sums the values of map m. It supports both int64 and float64
// as types for map values.
func SumIntsOrFloats[K comparable, V int64 | float64](m map[K]V) V {
    var s V
    for _, v := range m {
        s += v
    }
    return s
}

在这段代码里，你：

• 声明了一个带有 2 个类型参数 (方括号内) 的 SumIntsOrFloats 函数，K 和 V，一个使用类型参数的参数，类型为 map[K] V 的参数 m。
• 为 K 类型参数指定可比较的类型约束。事实上，针对此类情况，在 Go 里面可比较的限制是会提前声明。它允许任何类型的值可以作为比较运算符==和!=的操作符。在 Go 里面，map 的 key 是需要可比较的。因此，将 K 声明为可比较的是很有必要的，这样你就可以使用 K 作为 map 变量的 key。这样也保证了调用代码方使用一个被允许的类型做 map 的 key。
• 为 V 类型参数指定一个两个类型合集的类型约束：int64 和 float64。使用|指定了 2 个类型的合集，表示约束允许这两种类型。任何一个类型都会被编译器认定为合法的传参参数。指定参数 m 为类型 map[K] V，其中 K 和 V 的类型已经指定为类型参数。注意到因为 K 是可比较的类型，所以 map[K] V 是一个有效的 map 类型。如果我们没有声明 K 是可比较的，那么编译器会拒绝对 map[K] V 的引用。

2、 在 main.go 里，在你现在的代码下方，粘贴如下代码：

fmt.Printf("Generic Sums: %v and %v\n",
    SumIntsOrFloats[string, int64](ints),
    SumIntsOrFloats[string, float64](floats))

在这段代码里，你：

• 调用你刚才声明的泛型函数，传递你创建的每个 map。

• 指定类型参数 - 在方括号内的类型名称 - 来明确你所调用的函数中应该用哪些类型来替代类型参数。

你将会在下一节看到，你通常可以在函数调用时省略类型参数。Go 通常可以从代码里推断出来。

• 打印函数返回的总和。

运行代码

在 main.go 所在目录下，通过命令行运行代码

$ go run .
Non-Generic Sums: 46 and 62.97
Generic Sums: 46 and 62.97

为了运行你的代码，在每次调用的时候，编译器都会用该调用中指定的具体类型替换类型参数。

在调用你写的泛型函数时，你指定了类型参数来告诉编译器用什么类型来替换函数的类型参数。正如你将在下一节所看到的，在许多情况下，你可以省略这些类型参数，因为编译器可以推断出它们。

在这一节，你会添加一个泛型函数调用的修改版本，通过一个小的改变来简化代码。在这个例子里你将移除掉不需要的类型参数。

当 Go 编译器可以推断出你要使用的类型时，你可以在调用代码中省略类型参数。编译器从函数参数的类型中推断出类型参数。

注意这不是每次都可行的。举个例子，如果你需要调用一个没有参数的泛型函数，那么你需要在调用函数时带上类型参数。

写代码

• 在 main.go 的代码下方，粘贴下面的代码。

fmt.Printf("Generic Sums, type parameters inferred: %v and %v\n",
    SumIntsOrFloats(ints),
    SumIntsOrFloats(floats))

在这段代码里，你：

• 调用泛型函数，省略类型参数。

运行代码

在 main.go 所在目录下，通过命令行运行代码

$ go run .
Non-Generic Sums: 46 and 62.97
Generic Sums: 46 and 62.97
Generic Sums, type parameters inferred: 46 and 62.97

接下来，你将通过把整数和浮点数的合集定义到一个你可以重复使用的类型约束中，比如从其他的代码，来进一步简化这个函数。

在最后一节中，你将把你先前定义的约束移到它自己的 interface 中，这样你就可以在多个地方重复使用它。以这种方式声明约束有助于简化代码，尤其当一个约束越来越复杂的时候。

你将类型参数定义为一个 interface。约束允许任何类型实现这个 interface。举个例子，如果你定义了一个有三个方法的类型参数 interface，然后用它作为一个泛型函数的类型参数，那么调用这个函数的类型参数必须实现这些方法。

你将在本节中看到，约束 interface 也可以指代特定的类型。

1、 在 main 函数上面，紧接着 import 下方，粘贴如下代码来定义类型约束。

type Number interface {
    int64 | float64
}

在这段代码里，你：

• 声明一个 Number interface 类型作为类型限制

• 在 interface 内声明 int64 和 float64 的合集 本质上，你是在把函数声明中的合集移到一个新的类型约束中。这样子，当你想要约束一个类型参数为 int64 或者 float64，你可以使用 Number interface 而不是写 int64 | float64。

2、 在你已写好的函数下方，粘贴如下泛型函数，SumNumbers。

// SumNumbers sums the values of map m. Its supports both integers
// and floats as map values.
func SumNumbers[K comparable, V Number](m map[K]V) V {
    var s V
    for _, v := range m {
        s += v
    }
    return s
}

在这段代码，你：

• 声明一个泛型函数，其逻辑与你之前声明的泛型函数相同，但是是使用新的 interface 类型作为类型参数而不是合集。和之前一样，你使用类型参数作为参数和返回类型。3、 在 main.go，在你已写完的代码下方，粘贴如下代码。

fmt.Printf("Generic Sums with Constraint: %v and %v\n",
    SumNumbers(ints),
    SumNumbers(floats))

在这段代码里，你：

• 每个 map 依次调用 SumNumbers，并打印数值的总和。
• 与上一节一样，你可以在调用泛型函数时省略类型参数（方括号中的类型名称）。Go 编译器可以从其他参数中推断出类型参数。

运行代码

在 main.go 所在目录下，通过命令行运行代码

$ go run .
Non-Generic Sums: 46 and 62.97
Generic Sums: 46 and 62.97
Generic Sums, type parameters inferred: 46 and 62.97
Generic Sums with Constraint: 46 and 62.97

完美结束！你刚才已经给你自己介绍了 Go 的泛型。

如果你想继续试验，你可以尝试用整数约束和浮点数约束来写 Number interface，来允许更多的数字类型。

建议阅读的相关文章：

• Go Tour 是一个很好的，手把手教 Go 基础的介绍。
• 你可以在 Effective Go 和 How to write Go code 中找到非常实用的 GO 的练习。

你可以在 Go playground 运行这个代码。在 playground 只需要点击Run按钮即可。

package main

import "fmt"

type Number interface {
    int64 | float64
}

func main() {
    // Initialize a map for the integer values
    ints := map[string]int64{
        "first": 34,
        "second": 12,
    }

    // Initialize a map for the float values
    floats := map[string]float64{
        "first": 35.98,
        "second": 26.99,
    }

    fmt.Printf("Non-Generic Sums: %v and %v\n",
        SumInts(ints),
        SumFloats(floats))

    fmt.Printf("Generic Sums: %v and %v\n",
        SumIntsOrFloats[string, int64](ints),
        SumIntsOrFloats[string, float64](floats))

    fmt.Printf("Generic Sums, type parameters inferred: %v and %v\n",
        SumIntsOrFloats(ints),
        SumIntsOrFloats(floats))

    fmt.Printf("Generic Sums with Constraint: %v and %v\n",
        SumNumbers(ints),
        SumNumbers(floats))
}

// SumInts adds together the values of m.
func SumInts(m map[string]int64) int64 {
    var s int64
    for _, v := range m {
        s += v
    }
    return s
}

// SumFloats adds together the values of m.
func SumFloats(m map[string]float64) float64 {
    var s float64
    for _, v := range m {
        s += v
    }
    return s
}

// SumIntsOrFloats sums the values of map m. It supports both floats and integers
// as map values.
func SumIntsOrFloats[K comparable, V int64 | float64](m map[K]V) V {
    var s V
    for _, v := range m {
        s += v
    }
    return s
}

// SumNumbers sums the values of map m. Its supports both integers
// and floats as map values.
func SumNumbers[K comparable, V Number](m map[K]V) V {
    var s V
    for _, v := range m {
        s += v
    }
    return s
}