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

大家好，我是 frank。 欢迎大家点击标题下方蓝色文字「Golang 语言开发栈」关注公众号。

01

介绍

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

在之前的文章中，我们介绍过 Go Modules 的详细使用方式，本文不再赘述，感兴趣的读者朋友们请查阅历史文章。

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

1. go mod init 创建一个新模块，初始化 go.mod 文件。
2. go build、go test、go run、go install 等构建命令，向 go.mod 文件中添加模块所需的依赖项。
3. go list -m -json all 打印当前模块的依赖项。
4. go get 添加依赖项，或修改依赖项版本。
5. go mod tidy 删除未使用的依赖项。

02

Go Modules 演进史

Go v1.11

从 Go v1.11 开始支持 Go Moduls。

为了兼容使用 Go v1.11 之前的任意版本的项目，当设置 GO111MODULE=auto 或 GO111MODULE=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=off 或 GO111MODULE=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 仍然构建和安装包。

03

总结

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

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

推荐阅读：

1. Go 语言开源项目使用的函数选项模式
2. Go 语言 errgroup 库的使用方式和实现原理
3. Go 语言整洁架构实践
4. Go 语言怎么使用 Docker 部署项目？
5. Go 项目使用 Makefile

参考资料：

1. https://github.com/golang/go/wiki/Modules
2. https://github.com/golang/go/wiki/Modules#github-issues