Golang-Modules的演进史
介绍
Go 语言在 v1.11 开始支持 Modules,本文我们介绍一下 Go 语言各个版本支持 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
删除未使用的依赖项。
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 仍然构建和安装包。
总结
本文介绍 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 模式。