..

Golang-Modules的演进史

介绍

Go 语言在 v1.11 开始支持 Modules,本文我们介绍一下 Go 语言各个版本支持 Go Modules 的演进史。

使用 Go Modules 模式,一般分为以下几个流程:

  • go mod init 创建一个新模块,初始化 go.mod 文件。
  • go buildgo testgo rungo install 等构建命令,向 go.mod文件中添加模块所需的依赖项。
  • go list -m -json all 打印当前模块的依赖项。
  • go get 添加依赖项,或修改依赖项版本。
  • go mod tidy 删除未使用的依赖项。

Go Modules 演进史

Go v1.11 从 Go v1.11 开始支持 Go Moduls。 为了兼容使用 Go v1.11 之前的任意版本的项目,当设置 GO111MODULE=autoGO111MODULE=off 时,Go v1.11 在 $GOPATH/src 中,继续使用 GOPATH 模式。 当设置 GO111MODULE=auto 时,其它任意位置,如果当前目录或父目录包含 go.mod 文件,则使用 Modules 模式。

注意:GO111MODULE 包含三个模式,分别是 auto、on 和 off,其中默认值是 auto,即不显式设置 GO111MODULE 的值,默认是 auto 模式。

Go v1.13 在 Go v1.13 中,Go Modules 发生一些变化:

当设置 GO111MODULE=auto 时,如果在任意位置找到 go.mod 文件,则使用 Go Modules 模式,即使在 $GOPATH/src 中。

注意:在 Go v1.13 之前,即使 GO111MODULE=auto,在 $GOPATH/src 目录中也不会启动 Go Modules 模式。

go get 的变化:

  • go get -u (不包含任何参数),现在只升级当前包的直接和间接依赖,并且不再检查整个模块。
  • go get -u ./... 从模块根升级模块的所有直接和间接依赖项,现在排除测试依赖项。
  • go get -u -t ./... 从模块根升级模块的所有直接和间接依赖项,而且还会升级测试依赖项。

Go v1.14 从 Go v1.14 开始,模块被认为可以用于生产环境,并且鼓励所有用户从其他依赖管理系统迁移到模块。 当主模块包含一个顶级 vendor 目录,并且它的 go.mod 文件指定 go 1.14 或更高版本时,对于支持 -mod=vendor 的 go 命令,将默认添加 -mod=vendor

Go v1.15 模块缓存的位置现在可以使用 GOMODCACHE 环境变量进行设置。GOMODCACHE 的默认值是 GOPATH[0]/pkg/mod,这也是不支持使用 GOMODCACHE 环境变量进行设置之前的模块缓存的位置。

注意:可以使用 GOPATH 环境变量设置多个目录。

Go v1.16 模块模式(GO111MODULE=on)默认开启,也就是说默认启用 Go Modules 模式,如果用户想要使用 GOPATH 模式,需要显式设置 GO111MODULE=offGO111MODULE=auto(并且需要在 $GOPATH/src 目录)。 使用 go install pkg@version 替换 go get pkg@version 全局安装包和可执行文件。

注意:在 Modules 模式 go get 不再用于构建或安装包,而是专门用于调整 go.mod 中的依赖项,如果在模块外执行 go get 将会报错,因为没有可更新的 go.mod 文件;在 GOPATH 模式(GO111MODULE=off) go get 仍然构建和安装包。

总结

本文介绍 Go Modules 模式在 Go 语言各个版本中的演进史,限于篇幅,仅介绍的在使用时常用操作的变化,我们最后做一下总结:

  1. Go v1.11 开始支持 Go Modules 模式
  2. Go v1.13 在(包含 $GOPATH/src )任意目录找到 go.mod 文件,都开启 Go Modules 模式
  3. Go v1.14 推荐在生产环境使用
  4. Go v1.16 默认开启 Go Modules 模式。

参考

Go 语言各个版本支持 Go Modules 的演进史