Golang的向前兼容性和toolchain规则，Go1.21.0

在 Go 1.21 中，在工具上新增了两个变化：增强了向前兼容性；工具链管理。

向前兼容性

在以前的版本中，Go 工具链尝试编译依赖于新版本的代码时，可能会遇到兼容性问题。例如，如果你的代码依赖于 Go 1.18 引入的新特性，使用早期版本的 Go 编译器将会导致编译错误。但是，这些错误信息有时并不直观，可能仅仅显示为语法错误，而实际上是由于工具链版本不匹配。

在 Go 1.21 中，工具链会严格遵循 go.mod 文件中的版本声明。例如，如果你的 go.mod 文件中声明了 go 1.21.1，那么 Go 1.21.0 将无法编译这段代码。这种方式有效地避免了潜在的编译错误。

工具链管理

为了减少强制版本匹配对开发者的影响，Go 1.21 还引入了工具链管理功能，使得你可以为不同的模块指定不同的工具链版本。这一功能类似于 Node 的 nvm 或 Rust 的 rustup，但它是内置于 Go 的核心工具中。

// go.mod 文件
module example

go 1.21.0
toolchain go1.21.4

在上面的配置中，toolchain go1.21.4 指定了在当前模块中需要使用 Go 1.21.4 工具链。Go 命令会自动下载并使用指定的工具链版本，而无需手动干预。

更新 go.mod 中的 go 行：

go get go@1.21.0，该命令将下载并切换到 Go 1.21.0 版本，并自动更新 go 行。

如果你希望在保持旧版本 go 行不变的情况下更新工具链，可以使用：go get toolchain@go1.21.0

使用场景：

• Go v1 的时候开发了项目（或者叫模块）project1；后来使用 Go v2 的时候开发了模块 project2，因为此时你本地安装的是Go v2，虽然你可以使用v2来编译project1，但总归心里不踏实，现在会自动选择v1来编译project1。
• project2 依赖的第三方包要求 Go v3，你不需要更新本地Go版本，也不需要降低第三方包的版本，使用toolchain gov3即可。

在 Go 1.21 之后我们要分清楚几个概念

• go命令，它与Go版本无关，就是个命令。
• go.mod 中的 go 行，是当前模块开发的版本要求。
• go.mod 中的 toolchain 行，是依赖的第三方包的版本要求。
• 不同版本的Go会像普通的依赖包一样同时存在。

强制使用特定工具链版本

你可以通过 GOTOOLCHAIN 环境变量来强制使用特定版本的 Go 工具链。例如：GOTOOLCHAIN=go1.20.4 go test

这条命令将强制使用 Go 1.20.4 版本运行测试。

可以理解为在 Go 1.21 以前，我们用的是GOTOOLCHAIN=local，即使用你本地安装的Go版本。

在 Go 1.21 之后，如果Go发现本地工具链版本低于go mod要求的最低版本，那么Go会自动下载匹配的Go工具链，缓存到go module cache（不会覆盖本地安装的go工具链），保存在 pkg/mod 目录下，就像你下载普通的依赖一样，并用新下载的Go工具链对module进行编译构建。

也就是说，你本地现在可以有多个版本的Go工具链，主版本就是你的安装版本，其他的版本就是用来编译。

有时候你可能有多个项目，它们依赖不同的Go版本。

go xxx 就是初始化项目的时候你本地安装的Go版本。

toolchain goxxx 是编译时要求使用的Go版本，出现这种情况，可能是依赖的第三方包造成的，或者项目的不断演变引入的新特性造成的。

这就是所谓的向前兼容性，开发者可以放心使用新语言特性，无需担心旧版本编译器带来的问题，go命令会自动处理这一切

自动升级工具链

你还可以设置自动升级工具链版本。使用 GOTOOLCHAIN 环境变量的形式 version+auto 可以在保留当前版本的同时允许自动升级。例如：go env -w GOTOOLCHAIN=go1.21.1+auto

当 Go 1.21.1 发布时，你的系统将自动使用该版本。

Go 1.21 的工具链管理功能和向前兼容性改进将大大提升 Go 开发的便利性。通过这些新特性，你可以更好地管理不同版本的工具链，确保代码在不同版本的 Go 中稳定运行。

参考

Forward Compatibility and Toolchain Management in Go 1.21

Go Toolchains