【Golang】go mod的使用
【1】GO111MODULE有三个值：off, on, auto
off：go命令行将不会支持module功能，将会使用旧版本那种通过vendor目录或者GOPATH来查找依赖包的方式。
on：go命令行会使用modules功能，而不再去GOPATH目录下查找依赖包。
auto（默认值）：go命令行将会根据当前目录来决定是否启用module功能。在以下两种情形下使用module功能：a、当前目录在GOPATH/src之外，且该目录包含go.mod文件；b、当前文件在包含go.mod文件的目录下面。
【2】初始化模块：
go mod init whz_test(模块名称)
在当前目录会生产一个go.mod文件，同时还有一个go.sum文件。
go.mod和go.sum都应该加入到版本控制，但go.sum不需要手工维护。
子目录是不需要go mod init的，所有子目录中的依赖都会组织在根目录的 go.mod 文件中。
创建go.mod文件后，直接go run 或 go build 将会自动下载依赖包，并将依赖关系和版本写到go.mod和go.sum文件中。
【3】其他命令：
go mod download: 下载依赖包
go mod graph: 打印模块依赖图
go mod tidy: 拉取缺少的模块，移除不用的模块
go mod vendor: 将依赖复制到vendor下
go mod verify: 验证依赖是否正确
go mod why: 解释为什么需要依赖
【4】go.mod文件中支持4个命令：
module语句指定包的名称（即路径）
require语句指定依赖项模块
replace语句可以替换依赖项模块：不包含某个版本等
exclude语句可以忽略依赖项模块：排除一个特定的模块依赖，用此指明不拉取该版本
【5】举例：go.mod文件内容
--------------------------------------
module whz_test
go 1.19
require (
github.com/hashicorp/go-multierror v1.1.1
...
github.com/samber/lo v1.37.0
)
require (
github.com/hashicorp/errwrap v1.0.0 // indirect
github.com/modern-go/reflect2 v1.0.2 // indirect
golang.org/x/exp v0.0.0-20220303212507-bbda1eaf7a17 // indirect
)
exclude golang.org/x/time v0.3.0
replace golang.org/x/sync v0.1.0 => gitee.com/x/sync v0.1.0
replace golang.org/x/sync v0.1.0 => /User/local/...
--------------------------------------
[说明]
（1）在require语句间接引入的，会有indirect标识；
（2）replace语句可解决：对应依赖模块网络问题拉取不到，换个地方拉取；本地调试，不想发布到仓库。
【6】go.mod文件生产后，拉取指定的依赖，常用的命令：
go get 只拉取(更新)直接依赖
go get -u 拉取(更新)直接依赖和间接依赖模块
go get -u -t ./... 拉取(更新)直接依赖和间接依赖模块，包括单元测试中用到的。
（go get拉取依赖不需要精准指定依赖版本，可自动推断对应的版本号）
拉取指定版本的命令：
go get http://golang.org/x/text@latest 拉取最新的版本，若存在tag，则优先使用。
go get http://golang.org/x/text@master 拉取 master 分支的最新 commit。
go get http://golang.org/x/text@v0.3.2 拉取 tag 为 v0.3.2 的 commit。
go get http://golang.org/x/text@342b2e 拉取 hash 为 342b231 的 commit，最终可能转换为 v0.3.2。
【7】go mod模式下，goland可能会出现的问题：
使用go mod下载了指定的依赖后，在goland中提示错误，无法关联到这个依赖，不过在goland以及命令行都可以编译运行。
goland版本：2024.2.
检查goland的设置：
（1）在File->Settings设置了Global GOPATH使用了系统的环境变量：
[GOPATH]C:\whz_go_path
（2）使用go mod下载了依赖包：github.com/gin-gonic/gin
经检查，已经成功安装到了GOPATH路径了：
C:\whz_go_path\pkg\mod\github.com\gin-gonic\gin@v1.10.0
（3）在命令行编译成功，在goland中也可以编译运行成功，但是代码中main.go显示红色波浪线，提示有错误，无法解析依赖库“github.com/gin-gonic/gin“。
（4）经检查，是因为File->Settings->Go->GoModules设置中没有勾选以下选项：
Enable Go modules integration
勾选后问题解决。