执行go install报错go.mod:5: unknown directive: toolchain

背景

在安装etcd benchmark工具时报etcd-main/go.mod:5: unknown directive: toolchain

当前go版本为1.20。

为什么提交到toolchain？看看etcd的mod文件：

module go.etcd.io/etcd/v3

go 1.22

toolchain go1.22.2

果然看到了toolchain指令。

解决

在Go 1.21版本之前，该文件中go指令用于声明建议的Go版本，但并不强制实施。

但在Go 1.21版本后，向前兼容性策略的调整就是参考了go module对依赖的管理方法：即将go版本和go toolchain 版本作为一个module的“依赖”来管理。
为解决向前兼容不确定性的问题，Go从1.21版本开始，改变了go.mod中go x.x.x的语义：它不再是建议，而是指定了module最小可用的Go版本。

也就是说，按上面etcd 的mod文件来看，我们需要使用1.22版本。

尝试升级go版本到go1.22.2，重试发现解决了。

关于toolchain