Blog.5 Go Module

这世上太多的人，宁愿吃生活苦，也不愿吃自律的苦。大概是因为生活的苦，躺着就来了，而自律的苦，得自己去找。但只有吃得下自律的苦，才有成功的自由，没有一种成功是走得了捷径的，通向真正成功的唯一道路只有自律。越成功，越自律。越自律，越成功。

GO111MODULE

Go 1.1包含了对Go Modules的预支持，包括调整后的go get命令。后续版本总GOPATH和老的go get可能会被官方移除。

在Go Modules中支持了一个临时环境变量：GO111MODULE，可以赋值为off、on或auto。

1. 值为off，表示不支持Go Modules模式，Go仍然在vendor和GoPATH路径下查找依赖；
2. 值为on，表示当前明确使用Go Modules，Go不再去GOPATH下查找任何依赖；
3. 值为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

The -u flag instructs get to use the network to update the named packages and their dependencies. By default, get uses the network to check out missing packages but does not use it to look for updates to existing packages.

首先，go get解析需要新增哪些依赖。可以通过在包名后添加@version或者@branch等方式来取代命令的默认更新行为。如果后缀指定为@none，则表明该依赖应该被移除。

其次，go get会下载、编译、安装指定的包。包的安装模式也是被允许的，比如使用go get golang.org/x/perf/cmd/..来更新cmd下的所有子包。

go get -u <repo url>
go mod vendor

熟悉govendor的肯能会有一种熟悉的感觉，这不就是govendor add +e吗？