Golang之Go module简学

常用命令

go mod init  # initialize new module in current directory（在当前目录初始化go.mod）
go mod tidy  # add missing and remove unused modules(拉取缺少的模块，移除不用的模块)
go mod download  # download modules to local cache(下载依赖包)
go mod vendor  # make vendored copy of dependencies(将依赖复制到vendor下)
go mod edit  # edit go.mod from tools or scripts（编辑go.mod)
go mod graph  # print module requirement graph (打印模块依赖图)
go mod verify  # verify dependencies have expected content (验证依赖是否正确）
go mod why	 # explain why packages or modules are needed(解释为什么需要依赖)

使用go mod方式构建项目优点

1. 自动下载依赖包
2. 项目不必放在GOPATH/src内了
3. 项目内会生成一个go.mod文件，列出包依赖
4. 所有的第三方包会准确的指定版本号
5. 对于已经转移的包，可以用replace 申明替换，不需要改代码

go.mod文件关键字

• module
  定义模组路径

• go
  定义go语言version

• require
  指定依赖的套件，预设是最新版，可以指定版本号

• exclude
  排除该套件和其版本

• replace
  由于某些已知的原因，并不是所有的package都能成功下载，比如：golang.org下的包。
  modules 可以通过在 go.mod 文件中使用 replace 指令替换成github上对应的库，比如：

replace (
    golang.org/x/crypto v0.0.0-20190313024323-a1f597ede03a => github.com/golang/crypto v0.0.0-20190313024323-a1f597ede03a
)

• 注解
  // 单行注解
  / 多行注解/
• indirect
  代表被间接导入的依赖包

1. go.mod文件一旦创建后，它的内容将会被go toolchain全面掌控。go toolchain会在各类命令执行时，比如go get、go build、go mod等修改和维护go.mod文件。
2. go module 安装 package 的原則是先拉最新的 release tag，若无tag则拉最新的commit
3. go 会自动生成一个 go.sum 文件来记录 dependency tree

包升级

1. 可以使用命令 go list -m -u all 来检查可以升级的package，使用go get -u need-upgrade-package 升级后会将新的依赖版本更新到go.mod文件中。
2. 也可以使用 go get -u 升级所有依赖。

go get升级

1. 运行 go get -u 将会升级到最新的次要版本或者修订版本(x.y.z, z是修订版本号， y是次要版本号)
2. 运行 go get -u=patch 将会升级到最新的修订版本
3. 运行 go get package@version 将会升级到指定的版本号version
4. 运行go get如果有版本的更改，那么go.mod文件也会更改

扩展包安装位置

1. 只要有开启go modules功能，go get 就不会像以前一样在GOPATH/src下放置套件档案，而是会放在GOPATH/pkg/mod里面，并且go.mod会写好引入，这样也就不用使用go mod download指令了。
2. go mod download 会直接将第三方包放在GOPATH/pkg/mod里面
3. 直接运行go build or go install 也会自动将套件安装在相对应的地方

官方说明

官方说明：除了go.mod之外，go命令还维护一个名为go.sum的文件，其中包含特定模块版本内容的预期加密哈希
go命令使用go.sum文件确保这些模块的未来下载检索与第一次下载相同的位，以确保项目所依赖的模块不会出现意外更改，无论是出于恶意、意外还是其他原因。 go.mod和go.sum都应检入版本控制。
go.sum 不需要手工维护，所以可以不用太关注。

取包原理

https://segmentfault.com/a/1190000018414744