依赖管理系统 go modules

OStack程序员社区-中国程序员成长平台 › 门户 › 编程› Go›Go教程

原作者: [db:作者] 来自: [db:来源] 收藏邀请

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/[email protected]    # 匹配 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/[email protected]" 可以主动修改 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 升级所有依赖