分享每一天-掌握Go mod常用与高级操作

掌握Go mod常用与高级操作

GoLang 1271 0 创建时间：2022-03-09 10:31:30

go mod golang Go module

#### 1. 开启Go module
1.11和1.12版本 ++
将下面两个设置添加到系统的环境变量中

```go
GO111MODULE=on
GOPROXY=https://goproxy.io
```

1.13版本之后
需要注意的是这种方式并不会覆盖之前的配置，有点坑，你需要先把系统的环境变量里面的给删掉再设置
```go
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,https://goproxy.io,direct
```

#### 2. go get使用
使用go module之后，go get 拉取依赖的方式就发生了变化

下载项目依赖
```go
go get ./...
```
拉取最新的版本(优先择取 tag)
```go
go get golang.org/x/text@latest
```
拉取 master 分支的最新 commit
```go
go get golang.org/x/text@master
```
拉取 tag 为 v0.3.2 的 commit
```go
go get golang.org/x/text@v0.3.2
```
拉取 hash 为 342b231 的 commit，最终会被转换为 v0.3.2：
```go
go get golang.org/x/text@342b2e
```
指定版本拉取，拉取v3版本
```go
go get github.com/smartwalle/alipay/v3
```
更新
```go
go get -u
```
#### 3. mod基本操作

初始化一个moudle，模块名为你项目名
```go
go mod init 模块名
```
下载modules到本地cache
> 目前所有模块版本数据均缓存在 $GOPATH/pkg/mod和 $GOPATH/pkg/sum 下
```go
go mod download
```

编辑go.mod文件 选项有-json、-require和-exclude，可以使用帮助go help mod edit
```go
go mod edit
```
以文本模式打印模块需求图
```go
go mod graph
```
删除错误或者不使用的modules
```go
go mod tidy
```
生成vendor目录
```go
go mod vendor
```
验证依赖是否正确
```go
go mod verify
```
查找依赖
```go
go mod why
```

#### 4. mod高级操作

更新到最新版本
```go
go get github.com/gogf/gf@version
```
> 如果没有指明 version 的情况下，则默认先下载打了 tag 的 release 版本，比如 v0.4.5 或者 v1.2.3；如果没有 release 版本，则下载最新的 pre release 版本，比如 v0.0.1-pre1。如果还没有则下载最新的 commit

更新到某个分支最新的代码
```go
go get github.com/gogf/gf@master
```
更新到最新的修订版（只改bug的版本）
```go
go get -u=patch github.com/gogf/gf
```

替代只能翻墙下载的库
```go
go mod edit -replace=golang.org/x/crypto@v0.0.0=github.com/golang/crypto@latest
go mod edit -replace=golang.org/x/sys@v0.0.0=github.com/golang/sys@latest
```
清理moudle 缓存
```go
go clean -modcache
```
查看可下载版本
```go
go list -m -versions github.com/gogf/gf
```

#### 查看go.mod文件

- module：用于定义当前项目的模块路径。
- go：用于标识当前模块的 Go 语言版本，值为初始化模块时的版本，目前来看还只是个标识作用。
- require：用于设置一个特定的模块版本。
- exclude：用于从使用中排除一个特定的模块版本。
- replace：用于将一个模块版本替换为另外一个模块版本。

另外你会发现 example.com/pear 的后面会有一个 indirect 标识，indirect 标识表示该模块为间接依赖，也就是在当前应用程序中的 import 语句中，并没有发现这个模块的明确引用，有可能是你先手动 go get 拉取下来的，也有可能是你所依赖的模块所依赖的，情况有好几种。

#### 查看go.sum文件

在第一次拉取模块依赖后，会发现多出了一个 go.sum 文件，其详细罗列了当前项目直接或间接依赖的所有模块版本，并写明了那些模块版本的 SHA-256 哈希值以备 Go 在今后的操作中保证项目所依赖的那些模块版本不会被篡改。

#### 查看全局缓存

我们刚刚成功的将 github.com/eddycjy/mquote 模块拉取了下来，其拉取的结果缓存在  $GOPATH/pkg/mod和 $GOPATH/pkg/sumdb 目录下，而在mod目录下会以 github.com/foo/bar 的格式进行存放，如下：
```go
mod
├── cache
├── github.com
├── golang.org
├── google.golang.org
├── gopkg.in
...
```
需要注意的是同一个模块版本的数据只缓存一份，所有其它模块共享使用。如果你希望清理所有已缓存的模块版本数据，可以执行 go clean -modcache 命令。

掌握Go mod常用与高级操作

商品推荐

广告推荐

推荐文章