【GO go modules 的 go mod 】

go mod

go mod 是什么？

go modules 模块是相关Go包的集合。modules是源代码交换和版本控制的单元。
go命令直接支持使用modules，包括记录和解析对其他模块的依赖性。modules替换旧的基于GOPATH的方法来指定在给定构建中使用哪些源文件。

代理设置

随着 module 概念引入 go 语言，每个引入的 module都有了版本。随着代码库的不断更新迭代，大家即使是对同一个代码库的引用也可能用了不同的 tag 或者 commit hash。于是，我们需要一个 proxy（代理）。

代理地址

主要有两个地址，如下：

1.https://goproxy.io
2.https://athens.azurefd.net

设置方法

Windows:
$env:GOPROXY = “https://goproxy.io”
Linux:
export GOPROXY=https://goproxy.io

如何使用go.mod?

1. 首先将go的版本升级为1.11以上
2. 设置GO111MODULE
   GO111MODULE值描述offgo命令行将不会支持module功能，寻找依赖包的方式将会沿用旧版本那种通过vendor目录或者GOPATH模式来查找。ongo命令行会使用modules，而一点也不会去GOPATH目录下查找。auto默认值，go命令行将会根据当前目录来决定是否启用module功能。这种情况下可以分为两种情形：1. 当前目录在GOPATH/src之外且该目录包含go.mod文件2. 当前文件在包含go.mod文件的目录下面。

   go mod详细命令

go.mod 提供了 module、require、replace 和 exclude 四个文件命令，如下：
go mod文件命令描述module语句指定包的名字（路径）require语句指定的依赖项模块replace语句可以替换依赖项模块exclude语句可以忽略依赖项模块

go mod命令

go mod命令意义描述go mod download下载模块到本地缓存，缓存路径是 $GOPATH/pkg/mod/cachego mod edit是提供了命令版编辑 go.mod 的功能，例如 go mod edit -fmtgo.mod会格式化 go.modgo mod graph把模块之间的依赖图显示出来go mod init生成 go.mod 文件，此命令会在当前目录中初始化和创建一个新的go.mod文件，该命令是为了简便操作。go mod tidy增加缺失的包，移除没用的包go mod vendor把依赖拷贝到 vendor/ 目录下go mod verify确认依赖关系go mod why解释为什么需要包和模块
注意有几个地方需要注意：

1. go mod 命令在$GOPATH 里默认是执行不了的，因为 GO111MODULE 的默认值是 auto。默认在 $GOPATH 里是不会执行， 如果一定要强制执行，就设置环境变量为on。
2. go mod init 在没有接module名字的时候是执行不了的，会报错 go: cannot determine module path for source directory。可以这样执行
3. 遇到这个go: modules disabled inside GOPATH/src by GO111MODULE=auto; see 'go help modules’问题

开启go module：
set GO111MODULE=on //windows
export GO111MODULE=on //linux

1. 遇到$GOPATH/go.mod exists but should not问题

开启模块支持后（set GO111MODULE=on），并不能与

     G
    
    
     O
    
    
     P
    
    
     A
    
    
     T
    
    
     H
    
    
     共存，所以把
    
   
   
    GOPATH共存，所以把
   
  
 GOPATH共存，所以把GOPATH从env中移出即可（unset GOPATH），可运行“unset GOPATH && make”。

go mod的使用

1. 创建一个空的项目文件夹 D:\…\gomod
2. 项目初始化： #Linux export GO111MODULE=on export GOPROXY=https://goproxy.io /#Windows $env:GO111MODULE=on // 不会去GOPATH目录下查找，使用modules。 $env:GOPROXY=“https: // goproxy.io”//设置代理地址 // 根据当前目录中初始化和创建一个新的go.mod文件 go mod init [module name]

当我们使用 go build，go test 时，go 会自动得更新 go.mod 文件，将依赖关系写入其中。