Golang基础-Go Modules的使用

最新推荐文章于 2024-06-14 10:52:25 发布

小羊爱吃肉

最新推荐文章于 2024-06-14 10:52:25 发布

阅读量438

点赞数

分类专栏： Golang基础文章标签： go golang

本文链接：https://blog.csdn.net/itman1996/article/details/108961258

版权

Golang基础专栏收录该内容

6 篇文章 0 订阅

订阅专栏

本文介绍了Go Modules作为Go语言的依赖管理工具，从Go 1.11开始成为默认选项。详细阐述了如何设置环境变量，特别是设置GOPROXY以解决国内访问问题。讨论了go mod常用命令，如`go.mod`文件的结构，`require`、`indirect`和`replace`的用法。还探讨了如何使用`go get`下载和升级依赖，以及回退版本的策略。最后，说明了在新项目和老项目中如何启用和使用Go Modules。

摘要由CSDN通过智能技术生成

介绍

go module是Go1.11版本之后官方推出的版本管理工具，并且从Go1.13版本开始，go module将是Go语言默认的依赖管理工具。从 Go 1.11 开始，Go 允许在 GOPATH/src 外的任何目录下使用 go.mod 创建项目。在GOPATH/src中，为了兼容性，Go 命令仍然在旧的 GOPATH 模式下运行。
使用 go module 管理依赖后会在项目根目录下生成两个文件go.mod和go.sum。

设置

设置环境变量

export GO111MODULE=on

1.13之后使用

go env -w GO111MODULE=on

设置代理

export GOPROXY=https://goproxy.cn

Go1.13之后GOPROXY默认值为https://proxy.golang.org，在国内是无法访问的，所以十分建议大家设置GOPROXY，这里我推荐使用goproxy.cn。
1.13之后使用

go env -w GOPROXY=https://goproxy.cn,direct

go mod

常用命令

go mod download    下载依赖的module到本地cache（默认为$GOPATH/pkg/mod目录）
go mod edit        编辑go.mod文件
go mod graph       打印模块依赖图
go mod init        初始化当前文件夹, 创建go.mod文件
go mod tidy        增加缺少的module，删除无用的module
go mod vendor      将依赖复制到vendor下
go mod verify      校验依赖
go mod why         解释为什么需要依赖

go.mod

目录结构大致如下：
在这里插入图片描述

module用来定义包名
require用来定义依赖包及版本
indirect表示间接引用

replace

在国内访问golang.org/x的各个包被墙，你可以在go.mod中使用replace替换成github上对应的库。

例如：

replace (
	golang.org/x/text v0.3.0 => github.com/golang/text v0.3.0
)

go get

在项目中执行go get命令可以下载依赖包，并且还可以指定下载的版本。
运行go get -u将会升级到最新的次要版本或者修订版本(x.y.z, z是修订版本号， y是次要版本号)。
运行go get -u=patch将会升级到最新的修订版本。
运行go get package@version将会升级到指定的版本号version。
如果下载所有依赖可以使用go mod download命令。

其他案例

将 GIN 框架的版本回退到上个版本。这里需要使用一个命令查看依赖的版本历史。

go list -m -versions github.com/gin-gonic/gin

将会列出 Gin 版本历史

github.com/gin-gonic/gin v1.1.1 v1.1.2 v1.1.3 v1.1.4 v1.3.0

将版本更新到上个版本

go get github.com/gin-gonic/gin@v1.1.4 // 只需要在依赖后面加上 @version 就可以了
go list -m all

看到了版本变化

github.com/gin-gonic/gin v1.1.4

或者可以使用 go mod 来进行版本的切换，这样就需要两个步骤了

go mod edit -require="github.com/gin-gonic/gin@v1.1.4" // 修改 go.mod 文件
go tidy //下载更新依赖

在项目中使用

新项目
你可以在GOPATH之外创建新的项目。
1.go mod init packagename可以创建一个空的go.mod文件。
2.手动编辑go.mod中的require依赖项或执行go get自动发现、维护依赖。
3.go mod download可以下载所需要的依赖，但是依赖并不是下载到GOPATH中，而是GOPATH/pkg/mod中，多个项目可以共享缓存的module。
老项目
1.在项目目录下执行go mod init，生成一个go.mod文件。
2.执行go get，查找并记录当前项目的依赖，同时生成一个go.sum记录每个依赖库的版本和哈希值。