Go常用命令之go mod
Go mod
Go mod 的三种开启模式
- GO111MODULE
- on：支持Go mod模式
- off：不支持Go mod模式
- auto (默认模式)：如果代码在gopath下，则自动使用gopath模式；如果代码不在gopath下，则自动使用GO mod模式。
- 开启方式：
- Windows中，在环境变量中添加变量即可，变量名为 GO111MODULE ，变量值可设置为 on、off、auto。
- Linux中，只要在 /etc/profile 中添加 export GO111MODULE=on 或 export GO111MODULE=off 或 export GO111MODULE=auto。然后执行 source /etc/profile 刷新即可。
范式
go mod <command> [arguments]
command命令
download
范式： go download [-x] [-json] [modules]
作用：下载指定名字的模块，可为选择主模块依赖的模块匹配模式，或path@version形式的模块查询。如果download不带参数则代表英语与是主模块的所有依赖。
go命令将在常规执行（编译、调试等等）期间根据需要自动下载模块。go mod download的作用主要是预填充本地缓存或者计算Go模块代理的结果。
默认情况下go mod download 不向标准输出写入内容(可能会打印进度信息和错误日志)。
标志：
-
-json：打印一系列JSON对象至标准输出，描述每个下载的模块。 -
-x：打印实际需要执行的命令，并运行。
edit
范式：go mod edit [editing flags] [go.mod]
作用：edit提供一个编辑go.mod的命令行接口，主要提供给工具或脚本使用。它只读取go.mod；不查找涉及模块的信息。默认情况下，edit读写主模块的go.mod文件，但也可以在标志后指定不同的目标文件。
标志：
-
-dropexclude=path@version：删除给定模块路径和版本的排除项。 -
-dropreplace=old[@v]：删除给定模块路径和版本的替代。如果@v省略，删除该模块不带版本的替代。 -
-droprequire=path：删除给定的模块路径依赖要求的模块。该标志主要提供给工具用以理解模块图。用户应该使用“go get path@none”，可令其它go.mod根据需要调整来满足其它模块施加的限制。 -
-exclude=path@version：添加给定模块路径和版本的排除项。注意如果排除项已经存在-exclude=path@version是无操作的。 -
-fmt：重新格式化go.mod文件，不作其他改变。使用或重写go.mod文件的任何其他修改也意味着这种重新格式化。需要该标志的唯一情形是没有指定其它标志，如“go mod edit -fmt”。 -
-go=version：设置期望的Go语言版本。 -
-json：以JSON格式打印最终的go.mod，而不是将其写回go.mod。JSON输出对应于这些Go类型：type Module struct { Path string Version string } type GoMod struct { Module Module Go string Require []Require Exclude []Module Replace []Replace } type Require struct { Path string Version string Indirect bool } type Replace struct { Old Module New Module } -
-module：修改模块路径（go.mod文件的模块行）。 -
-print：以其文本格式打印最终的go.mod，而不是将其写回go.mod。 -
-replace=old[@v]=new[@v]：添加给定模块路径和版本对的替代。如果old@v中的@v省略，则左侧不带版本的替代将被添加，应用于old模块路径的所有版本。如果new@v中的@v省略，新路径应为本地模块根目录，而不是模块路径。注意-replace覆盖old[@v]任何冗余的替代，因此省略@v将删除对特定版本的现有替代。 -
-require=path@version：添加给定的模块路径和版本依赖要求的模块。注意-require覆盖该路径任何已存在的依赖要求的模块。该标志主要提供给工具用以理解模块图。用户应该使用“go get path@version”，其可令其它go.mod根据需要调整来满足其它模块施加的限制。
-require、-droprequire、-exclude、-dropexclude、-replace、-dropreplace标志可以重复，根据给定的顺序应用修改。
注意这只描述go.mod文件自身，不描述其他间接引用的模块。对于构建可使用的的模块的完整集合，使用“go list -m -json all”。
例如，工具可以通过解析“go mod edit -json”的输出以数据结构体的方式获取go.mod，然后可通过使用-require、-exclude等调用“go mod edit”来作出修改，等等。
graph
范式：go mod graph
作用：以文本形式打印模块间的依赖关系图。输出的每一行行有两个字段（通过空格分割）；模块和其所有依赖中的一个。每个模块都被标记为path@version形式的字符串（除了主模块，因其没有@version后缀）。
init
范式： go mod init [module]
作用：初始化并写入一个新的go.mod至当前目录中，实际上是创建一个以当前目录为根的新模块。文件go.mod必须不存在。如果可能，init会从import注释（参阅“go help importpath”）或从版本控制配置猜测模块路径。要覆盖此猜测，提供模块路径作为参数 module为当前项目名
tidy
范式：go mod tidy [-v]
作用：确保go.mod与模块中的源代码一致。它添加构建当前模块的包和依赖所必须的任何缺少的模块，删除不提供任何有价值的包的未使用的模块。它也会添加任何缺少的条目至go.mod并删除任何不需要的条目。
标志：
-
-v：打印被删除的模块的信息至标准错误输出。
vendor
范式：go mod vendor [-v]
作用：重置主模块的vendor目录，使其包含构建和测试所有主模块的包所需要的所有包。不包括vendor中的包的测试代码。
标志：
-
-v：打印vendor的模块和包的名字至标准错误输出。
verify
范式：go mod verify
作用：检查存储在本地下载源代码缓存中的当前模块的依赖，是否自从下载之后未被修改。如果所有模块都未被修改，打印“all modules verified”。否则，报告哪个模块已经被修改并令“go mod”以非0状态退出。
why
范式：go mod why [-m] [-vendor] packages...
作用：输出每个包或者模块的引用块，每个块以注释行“# package”或“# module”开头，给出目标包或模块。随后的行通过导入图给出路径，一个包一行。每个块之间通过一个空行分割，如果包或模块没有被主模块引用，该小节将显示单独一个带圆括号的提示信息来表明该事实。
标志：
-
-m：默认情况下，why在导入图中展示从主模块到每个列出的包的最短路径。如果给出-m标志，why将参数视为一个模块的列表并找出每个模块中的所有包的路径。 -
-vendor：默认情况下，why查询与“go list all”匹配的包图，包括对可达包的测试相关的包。-vendor标志令why将依赖包的测试相关的包排除在外。
go.mod文件
模块版本是由源文件树定义的，在其根目录中有一个go.mod文件。当go命令运行时，它查找当前目录然后查找相继的父目录来找出go.mod，go.mod标记主模块的根。
go.mod文件自身是面向行的，带有//注释但没有/**/注释。每行包含单个指令，有一个动词后跟参数组成。
动词类型：
- module：定义模块路径。
- go：设置期望的语言版本。
- require：依赖要求一个给定版本或者之后的特定模块。
- exclude：从使用中排除特定模块版本。
- replace：以一个不同的，模块版呢嘛提到另一个模块版本。
exclude和replace只应用在主模块的go.mod中，并且在依赖中会被忽略。
常见错误汇总
go: modules disabled inside GOPATH/src by GO111MODULE=auto; see 'go help modules'
go mod init
go: modules disabled inside GOPATH/src by GO111MODULE=auto; see 'go help modules'
开启go module：
set GO111MODULE=on //windowsexport GO111MODULE=on //linux
$GOPATH/go.mod exists but should not
GO 1.11或之后模块遇到这个问题：
$GOPATH/go.mod exists but should not
开启模块支持后（set GO111MODULE=on），并不能与GOPATH从env中移出即可（unset GOPATH），可运行“unset GOPATH && make”
