依赖管理系统 go modules
-
golang在1.11版本中引入了新的包管理工具 go mod
-
类似于maven包管理(多项目公用)，而之前的vendor类似于node的node_modules管理(各个项目一份)
-
依赖信息添加到go.mod文件中，依赖版本哈希信息存到go.sum文件中
-
使用go mod时，必须在GOPATH目录之外新建一个目录
-
当我们使用 go build、go test 以及 go list 时，Go 会自动更新 go.mod 文件，并且将依赖关系写入其中
-
go mudules 版本规则，举例：vX.0.0-yyyymmddhhmmss-abcdefabcdef
- vX.Y.Z 是仓库打的标签版本，go modules是根据仓库标签来确定版本号的，因此我们发布版本时，需要给我们的仓库打上一个标签版本号。
- yyyymmddhhmmss 是时间戳
- abcdefabcdef是hash值，我们自己指定版本时只需要制定版本号即可，没有版本tag的则需要找到对应commit的时间和hash值。
-
go get
首先，go get解析需要新增哪些依赖。可以通过在包名后添加@version或者@branch等方式来取代命令的默认更新行为。如果后缀指定为@none，则表明该依赖应该被移除。
其次，go get会下载、编译、安装指定的包。包的安装模式也是被允许的，比如使用go get golang.org/x/perf/cmd/..来更新cmd下的所有子包。
- 运行 go get -u 将会升级到最新的次要版本或者修订版本(x.y.z, z是修订版本号， y是次要版本号)
- 运行 go get -u=patch 将会升级到最新的修订版本
- 运行 go get package@version 将会升级到指定的版本号version
- 运行go get如果有版本的更改，那么go.mod文件也会更改
go get -v github.com/gorilla/mux # 匹配最新的一个 tag
go get -v github.com/gorilla/mux@latest # 和上面一样
go get -v github.com/gorilla/mux@v1.6.2 # 匹配 v1.6.2
go get github.com/gorilla/mux@e3702bed2 # 匹配 v1.6.2
go get github.com/gorilla/mux@c856192 # 匹配 c85619274f5d
go get github.com/gorilla/mux@master # 匹配 master 分支
latest 匹配最新的 tag。
v1.2.6 完整版本的写法。
v1、v1.2 匹配带这个前缀的最新版本，如果最新版是 1.2.7，它们会匹配 1.2.7。
c856192 版本 hash 前缀、分支名、无语义化的标签，在 go.mod 里都会会使用约定写法 v0.0.0-20180517173623-c85619274f5d，也被称作伪版本
-
设置 GO111MODULE：可以用环境变量 GO111MODULE 开启或关闭模块支持，它有三个可选值：off、on、auto，默认值是 auto。
- GO111MODULE=off 无模块支持，go 会从 GOPATH 和 vendor 文件夹寻找包。
- GO111MODULE=on 模块支持，go 会忽略 GOPATH 和 vendor 文件夹，只根据 go.mod 下载依赖。
- GO111MODULE=auto 在 $GOPATH/src 外面且根目录有 go.mod 文件时，开启模块支持。
在使用模块的时候，GOPATH 是无意义的，不过它还是会把下载的依赖储存在 $GOPATH/pkg/mod 中，也会把 go install 的结果放在 $GOPATH/bin 中
-
Modules and vendoring
当使用module时，Go命令会完全忽略vendor目录。为了跟之前Go的依赖管理相兼容，我们可以使用go mod vendor 创建vendor目录来存储编译代码的依赖包。如果在编译的时候要使用vendor中的依赖包，需要使用go build -mod=vendor命令。
-
go module设置代理：export GOPROXY=https://goproxy.io
-
go.mod文件
-
module 语句指定包的名字（路径）
-
require 语句指定的依赖项模块
-
exclude 语句可以忽略依赖项模块
-
indirect 表示这个库是间接引用进来的
-
incompatible 猜测意思：主要版本不兼容
-
replace 语句可以替换依赖项模块
由于某些已知的原因，并不是所有的package都能成功下载，比如：golang.org下的包。
modules 可以通过在 go.mod 文件中使用 replace 指令替换成github上对应的库，比如：replace ( golang.org/x/crypto v0.0.0-20190313024323-a1f597ede03a => github.com/golang/crypto v0.0.0-20190313024323-a1f597ede03a golang.org/x/text v0.3.0 => github.com/golang/text v0.3.0 )依赖库中的replace对你的主go.mod不起作用，比如github.com/smallnest/rpcx的go.mod已经增加了replace,但是你的go.mod虽然require了rpcx的库，但是没有设置replace的话， go get还是会访问golang.org/x
-
-
命令：
- go mod init 初始化module
- go mod edit -require="github.com/gin-gonic/gin@v1.1.4" 可以主动修改 go.md 文件中依赖的版本号
- go mod tidy 自动清理掉不需要的依赖项，同时可以将依赖项更新到当前版本
- go list -m --json all 以json格式显示所有项目使用的依赖包
- go mod edit -fmt 格式化 go.mod 文件
- go mod vendor 生成 vendor 文件夹，方便利用vendor进行编译打包
- go get 获取依赖的特定版本，用来升级和降级依赖。可以自动修改 go.mod 文件，而且依赖的依赖版本号也可能会变。
在 go.mod 中使用 exclude 排除的包，不能 go get 下来 - go build -mod=vendor 使用vendor目录构建
- go build -mod=readonly 防止隐式修改go.mod，如果遇到有隐式修改的情况会报错，可以用来测试 go.mod 中的依赖是否整洁，但如果明确调用了go mod、go get 命令则依然会导致 go.mod 文件被修改
- go mod download 命令用于将依赖包缓存到本地Cache起来，类似于maven的.m2/repository。Mod Cache 路径默认在$GOPATH/pkg 下面：$GOPATH/pkg/mod
- go mod graph 打印模块依赖图
- go mod verify 验证依赖是否正确
- go list -m -u all 来检查可以升级的package
- go get -u 升级所有依赖
refer to
1、goland
4、Modules
