介绍

go module是Go1.11版本之后官方推出的版本管理工具，并且从Go1.13版本开始，go module将是Go语言默认的依赖管理工具。从 Go 1.11 开始，Go 允许在 GOPATH/src 外的任何目录下使用 go.mod 创建项目。在GOPATH/src中，为了兼容性，Go 命令仍然在旧的 GOPATH 模式下运行。 使用 go module 管理依赖后会在项目根目录下生成两个文件go.mod和go.sum。

设置

设置环境变量

export GO111MODULE=on

1.13之后使用

go env -w GO111MODULE=on

设置代理

export GOPROXY=https://goproxy.cn

Go1.13之后GOPROXY默认值为https://proxy.golang.org，在国内是无法访问的，所以十分建议大家设置GOPROXY，这里我推荐使用goproxy.cn。 1.13之后使用

go env -w GOPROXY=https://goproxy.cn,direct

go mod

常用命令

go mod download 下载依赖的module到本地cache（默认为$GOPATH/pkg/mod目录） go mod edit 编辑go.mod文件 go mod graph 打印模块依赖图 go mod init 初始化当前文件夹, 创建go.mod文件 go mod tidy 增加缺少的module，删除无用的module go mod vendor 将依赖复制到vendor下 go mod verify 校验依赖 go mod why 解释为什么需要依赖

go.mod

目录结构大致如下：

module用来定义包名require用来定义依赖包及版本indirect表示间接引用

replace

在国内访问golang.org/x的各个包被墙，你可以在go.mod中使用replace替换成github上对应的库。

例如：

replace ( golang.org/x/text v0.3.0 => github.com/golang/text v0.3.0 )

go get

在项目中执行go get命令可以下载依赖包，并且还可以指定下载的版本。 运行go get -u将会升级到最新的次要版本或者修订版本(x.y.z, z是修订版本号， y是次要版本号)。 运行go get -u=patch将会升级到最新的修订版本。 运行go get package@version将会升级到指定的版本号version。 如果下载所有依赖可以使用go mod download命令。

其他案例

将 GIN 框架的版本回退到上个版本。这里需要使用一个命令查看依赖的版本历史。

go list -m -versions github.com/gin-gonic/gin

将会列出 Gin 版本历史

github.com/gin-gonic/gin v1.1.1 v1.1.2 v1.1.3 v1.1.4 v1.3.0

将版本更新到上个版本

go get github.com/gin-gonic/gin@v1.1.4 // 只需要在依赖后面加上 @version 就可以了 go list -m all

看到了版本变化

github.com/gin-gonic/gin v1.1.4

或者可以使用 go mod 来进行版本的切换，这样就需要两个步骤了

go mod edit -require="github.com/gin-gonic/gin@v1.1.4" // 修改 go.mod 文件 go tidy //下载更新依赖

在项目中使用

新项目 你可以在GOPATH之外创建新的项目。 1.go mod init packagename可以创建一个空的go.mod文件。 2.手动编辑go.mod中的require依赖项或执行go get自动发现、维护依赖。 3.go mod download可以下载所需要的依赖，但是依赖并不是下载到GOPATH中，而是GOPATH/pkg/mod中，多个项目可以共享缓存的module。 老项目 1.在项目目录下执行go mod init，生成一个go.mod文件。 2.执行go get，查找并记录当前项目的依赖，同时生成一个go.sum记录每个依赖库的版本和哈希值。