Go Module(一)
Posted by 付辉 on Sunday, April 21, 2019 共1275字
这世上太多的人,宁愿吃生活苦,也不愿吃自律的苦。大概是因为生活的苦,躺着就来了,而自律的苦,得自己去找。但只有吃得下自律的苦,才有成功的自由,没有一种成功是走得了捷径的,通向真正成功的唯一道路只有自律。越成功,越自律。越自律,越成功。
GO111MODULE
Go 1.1包含了对Go Modules的预支持,包括调整后的go get命令。后续版本总GOPATH和老的go get可能会被官方移除。
在Go Modules中支持了一个临时环境变量:GO111MODULE,可以赋值为off、on或auto。
- 值为
off,表示不支持Go Modules模式,Go仍然在vendor和GoPATH路径下查找依赖; - 值为
on,表示当前明确使用Go Modules,Go不再去GOPATH下查找任何依赖; - 值为
auto或未设置,表示是否启用Go Modules依赖当前的目录情况,当编译的项目在GoPATH/src之外,或者当前目录或子目录本身包含go.mod文件,则启用Go Modules模式。
Defining a module
module通过源码根目录下的go.mod文件来定义。根路径下的module是项目依赖包的集合,但会排除子目录的go.mod文件。
下面是go mod文件模版:
module example.com/m
require (
golang.org/x/text v0.3.0
gopkg.in/yaml.v2 v2.1.0
)
要开始使用go mod,仅需要在项目下执行go mod init命令创建go.mod文件即可。
go mod init example.com/m
The go.mod File
go.mod文件的每一行都包还一个简单的指令(module、require、exclude、replace),然后紧跟参数部分。指令除了单行表示之外,还可以是一个块的形式。其中,文件也是以//作为注释符。
下面是截取我项目下的go.mod文件的部分内容:
module gitlab.luojilab.com/igetserver/order_delivery
go 1.12
require (
github.com/Shopify/sarama v1.22.1
github.com/bsm/sarama-cluster v2.1.15+incompatible
github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b
github.com/gopherjs/gopherjs v0.0.0-20181103185306-d547d1d9531e // indirect
)
replace (
cloud.google.com/go => github.com/GoogleCloudPlatform/google-cloud-go v0.36.0
github.com/ugorji/go => github.com/ugorji/go/codec v0.0.0-20190204201341-e444a5086c43
golang.org/x/text => github.com/golang/text v0.3.0
)
go.mod中依赖库的版本标签都类似v.0.1.0,其中打头的v是必须的,三个表示版本的数字也是被要求的。当然,并不是严格要求。
go mod比较推崇这个给版本打release tag的方式,比如我们文件中的github.com/golang/text,引用的版本被项目开发者明确的标记为v0.3.0。而它非常反对我们通过具体的commit hash code来引用一个具体的开发版本,所以,他有一套默认的版本机制,格式就是:v0.0.0-yyyymmddhhmmss-commit,从我们的go.mod文件中也可以看出来。
Modules and vendoring
当使用module时,Go命令会完全忽略vendor目录。为了跟之前Go的依赖管理相兼容,我们可以使用go mod vendor 创建vendor目录来存储编译代码的依赖包。如果在编译的时候要使用vendor中的依赖包,需要使用go build -mod=vendor命令。
go mod vendor
go build -mod=vendor
Go Get
首先,go get解析需要新增哪些依赖。可以通过在包名后添加@version或者@branch等方式来取代命令的默认更新行为。如果后缀指定为@none,则表明该依赖应该被移除。
其次,go get会下载、编译、安装指定的包。包的安装模式也是被允许的,比如使用go get golang.org/x/perf/cmd/..来更新cmd下的所有子包。
go get -u <repo url>
go mod vendor