01 介绍
Go 语言在 v1.11 开始支持 Modules,本文我们介绍一下 Go 语言各个版本支持 Go Modules 的演进史。
在之前的文章中,我们介绍过 Go Modules 的详细使用方式,本文不再赘述,感兴趣的读者朋友们请查阅历史文章。
使用 Go Modules 模式,一般分为以下几个流程:
- go mod init 创建一个新模块,初始化 go.mod 文件。
- go build、go test、go run、go install 等构建命令,向 go.mod 文件中添加模块所需的依赖项。
- go list -m -json all 打印当前模块的依赖项。
- go get 添加依赖项,或修改依赖项版本。
- 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 模式。