简单说 Go Modules 就是包管理，从 go1.11 开始支持，可以不需要gopath存在，环境变量GO111MODULE，默认为 auto 项目存在 go.mod 则使用 go module ，否则使用GOPATH 和 vendor 机制。
这个解决的问题是：你引用的代码包上游变更不会直接影响你的项目，这显然是开始关心“包版本”了。遗憾的是依旧没有解决包管理的问题，比如不同的包依赖了同一个包的不同版本怎么办？版本间代码冲突怎么办？vendor 机制并没有解决，于是围绕 vendor/ 社区就出了几十个包管理工具，一时间百花齐放、百家争鸣、各有所长，导致 golang 的包管理生态变得有些混乱。
初始化
对于新建项目使用 go module：
1
2
3
4
5
6
$ export GO111MODULE=on
$ go mod init github.com/you/hello
// go build 会将项目的依赖添加到 go.mod 中
$ go build
对于已有项目要改为使用 go module：
1
2
3
4
5
6
7
$ export GO111MODULE=on
// 创建一个空的 go.mod 文件
$ go mod init .
// 查找依赖并记录在 go.mod 文件中
$ go get ./...
go.mod 文件必须要提交到 git 仓库，但 go.sum 文件可以不用提交到 git 仓库(git 忽略文件 .gitignore 中设置一下)。
项目的打包
首先需要使用 go mod vendor 将项目所有的依赖下载到本地 vendor 目录中然后进行编译，下面是一个参考：
1
2
3
4
5
6
7
8
9
10
#!/bin/bash
export GO111MODULE="on"
export GOPROXY="https://goproxy.io"
export CGO_ENABLED="0"
export GOOS="linux"
export GOARCH=amd64
go mod vendor
go build -ldflags "-s -w" -a -installsuffix cgo -o audit-webhook .
对于墙外的库
在go.mod中可以使用 replace 将特定的库替换成其他库：
1
2
3
replace (
golang.org/x/text v0.3.0 => github.com/golang/text v0.3.0
)
也可以使用阿里云的镜像站：
1$ export GOPROXY="https://mirrors.aliyun.com/goproxy/"
或
1$ export GOPROXY="https://goproxy.cn,direct"
什么情况下使用
一般是发布的开源程序，或私有源上使用这种方式管理依赖包。
go mod 命令一览
使用方式不习惯就不用，萝卜白菜，各有所爱。
本文网址: https://golangnote.com/topic/268.html 转摘请注明来源