教程集 www.jiaochengji.com
教程集 >  Golang编程  >  golang教程  >  正文 Go Modules 的使用

Go Modules 的使用

发布时间:2022-02-13   编辑:jiaochengji.com
教程集为您提供Go Modules 的使用等资源,欢迎您收藏本站,我们将为您提供最新的Go Modules 的使用资源

Go 语言中一直被人诟病的一个问题就是没有一个比较好用的依赖管理系统,GOPATH 的设计让开发者一直有很多怨言,在 Go 语言快速发展的过程中也出现了一些比较优秀的依赖管理工具,比如 govendor、dep、glide 等,有一些差不多成了半官方的工具了,但是这些工具都还是需要依赖于 GOPATH,为了彻底解决这个“祸水”,随着 Go1.11 的发布,Golang 官方给我们带来了依赖管理的全新特性 GoModules,这是 Golang 全新的一套依赖管理系统。下面我们就来看下 Go Modules 是如何使用的。

<h2>新建 Module</h2>

要使用 Go Modules 首先需要保证你环境中 Golang 版本大于1.11:

<pre><code class="lang-go hljs">$ go version go version go1.11.4 darwin/amd64</code></code></pre>

我们说 Go Modules 主要就是为了消除 GOPATH 的,所以我们新建的项目可以完全不用放在 $GOPATH/src目录下面,任何地方都可以:

<pre><code class="lang-go hljs">$ echo $GOPATH /Users/ych/devs/projects/go/</code></code></pre>

我们在目录 /Users/ych/devs/projects下面创建一个用于测试的工作目录:

<pre><code class="lang-go hljs">$ pwd /Users/ych/devs/projects $ mkdir stardust && cd stardust</code></code></pre>

在 stardust 目录下面创建一个用于字符串操作的 stringsx 的包:

<pre><code class="lang-go hljs">$ mkdir stringsx && cd stringsx</code></code></pre>

在包 stringsx 下面创建一个 string.go 的文件:

<pre><code class="lang-go hljs">package stringsx import ( "fmt" ) func Hello(name string) string{ return fmt.Sprintf("Hello, %s", name), nil }</code></code></pre>

现在我们的包里面的代码准备完成了,但还不是一个模块,我们需要使用 Go Modules 来做一些工作:

<pre><code class="lang-go hljs">$ export GO111MODULE=on # 开启GoModule特性</code></code></pre>

然后在项目根目录下面初始化 Go Module:

<pre><code class="lang-go hljs">$ pwd /Users/ych/devs/projects/stardust $ go mod init github.com/cnych/stardust go: creating new go.mod: module github.com/cnych/stardust</code></code></pre>

我们这里使用了一个命令:go mod init模块名,该命令会在当前目录下面生成一个 go.mod的文件,生成的内容就是包含一个模块名称的声明:

<pre><code class="lang-go hljs">module github.com/cnych/stardust</code></code></pre> <blockquote>

要注意 模块名非常重要,就这相当于声明了我们的模块名称,以后要想使用该模块就需要使用这个名称来获取模块。

</blockquote>

这一步操作非常简单,但是将我们当前的包变成了一个 Module 了,现在我们可以将这个代码推送到代码仓库上,我这里使用的是 Github,仓库地址:https://github.com/cnych/stardust

<pre><code class="lang-go hljs">$ git init $ git add . $ git commit -am "add stringsx package content" $ git remote add origin git@github.com:cnych/stardust.git $ git push -u origin master</code></code></pre>

到这里我们就完成了一个最简单的 Go Module 的编写,其他任何开发者想要使用我们这个模块的用户都可以通过 goget命令来获取了:

<pre><code class="lang-go hljs">$ go get github.com/cnych/stardust</code></code></pre>

不过上面的命令是获取 master 分支的最新代码,这样当然没有问题,但不是一个最佳实践的方式,因为很有可能我们这个模块会有新的内容更新,或者有一些 BUG 需要修复,如果我们都放在 master 分支上面的话,势必会造成使用者的混乱,因为很有可能使用者的代码在我们模块更新后就不兼容了,不过也不用担心,Go Moduels 就可以很好的来解决这个版本的问题。

<h2>Module 版本管理</h2>

Go Modules 是需要进行版本化管理的,就类似于我们平时写代码一样用不同的版本来进行区分。对于 Go Modules 的版本强烈推荐使用语义化的版本控制,对于语义化的版本控制我们查看响应的文档说明:https://semver.org,最主要的一个版本规则如下:

版本格式:主版本号.次版本号.修订号,版本号递增规则如下:

<ul><li>

主版本号:当你做了不兼容的 API 修改,

</li> <li>

次版本号:当你做了向下兼容的功能性新增,

</li> <li>修订号:当你做了向下兼容的问题修正。</li> </ul><blockquote> <pre><code class="lang-go hljs">先行版本号及版本编译元数据可以加到“主版本号.次版本号.修订号”的后面,作为延伸。</code></code></pre> </blockquote>

我们在使用 Go Modules 查找版本的时候会使用仓库中的 tags,并且某些版本和其他版本有一些不同之处,比如 v2 或者更高的版本要和 v1 的版本模块的导入路径要不同,这样才可以通过模块来区分使用的是不同的版本,当然默认情况下,Golang 会获取仓库中最新的 tag 版本。

<blockquote> <pre><code class="lang-go hljs">所以最重要的一点就是要发布我们的模块,我们需要使用 git tag 来标记我们的仓库版本。</code></code></pre> </blockquote> <h2>发布第一个版本</h2>

假如现在我们的包已经准备好了,可以发布 release 包了,首先我们就需要给当前的包打上一个 git tag,要记住使用语义化的版本,比如我们这里第一个版本就叫:v1.0.0:

<pre><code class="lang-go hljs">$ git tag v1.0.0 $ git push --tags</code></code></pre>

这样我们就会在 Github 上面创建了一个名为 v1.0.0 的 tag,但是一个更好的方式是去创建一个名为 v1的新分支,这样可以方便以后修复当前版本代码中的 BUG,也不会影响到 master 或者其他分支的一些代码:

<pre><code class="lang-go hljs">$ git checkout -b v1 $ git push -u origin v1</code></code></pre>

现在我们就完全不用担心会影响到我们之前的版本了。

<h2>模块使用</h2>

现在我们的模块已经准备好了,现在我们来创建一个简单的程序来使用上面的模块:

<pre><code class="lang-go hljs">$ pwd /Users/ych/devs/projects $ mkdir ch26-gomodules && cd ch26-gomodules</code></code></pre>

然后在 ch26-gomodules 目录下面创建一个 main.go 的文件:

<pre><code class="lang-go hljs">package main import ( "fmt" "github.com/cnych/stardust/stringsx" ) func main() { fmt.Println(stringsx.Hello("cnych")) }</code></code></pre>

程序里面使用了 github.com/cnych/stardust/stringsx这个包,在以前的话我们直接使用 goget命令将这个包拉到 GOPATH 或者 vendor 目录下面即可,现在我们是将这个包当成 modules 来使用,首先同样的在当前目录下面初始化模块:

<pre><code class="lang-go hljs">$ go mod init ch26-gomodules</code></code></pre>

同样的,该命令会在目录下面新建一个 go.mod的文件:

<pre><code class="lang-go hljs">module ch26-gomodules</code></code></pre>

这个时候我们来直接运行下我们当前的程序:

<pre><code class="lang-go hljs">$ go run main.go go: finding github.com/cnych/stardust v1.0.0 go: downloading github.com/cnych/stardust v1.0.0 Hello, cnych</code></code></pre>

上面的命令会去自动下载程序中导入的包,下载完成后可以查看下 go.mod文件内容:

<pre><code class="lang-go hljs">module ch26-gomodules require github.com/cnych/stardust v1.0.0</code></code></pre>

并且还在当前目录下面生成了一个名为 go.sum的新文件,里面包含了依赖包的一些 hash 信息,可以用来确保文件和版本的正确性:

<pre><code class="lang-go hljs">github.com/cnych/stardust v1.0.0 h1:8EcmmpIoIxq2VrzXdkwUYTD4OcMnYlZuLgNntZ DxUE= github.com/cnych/stardust v1.0.0/go.mod h1:Qgo0xT9MhtGo0zz48gnmbT9XjO/9kuuWKIOIKVqAv28=</code></code></pre>

模块会被下载到 $GOPATH/pkg/mod目录下面去:

<pre><code class="lang-go hljs">$ ls $GOPATH/pkg/mod/github.com/cnych stardust@v1.0.0</code></code></pre> <h2>发布一个 bugfix 版本</h2>

比如现在我们发现之前模块中的 Hello 函数有 bug,所以我们需要修复并发布一个新的版本:

<pre><code class="lang-go hljs">func Hello(name string) string{ return fmt.Sprintf("Hello, %s!!!", name), nil }</code></code></pre> <blockquote> <pre><code class="lang-go hljs">这里我们添加3个 !来模拟 bugfix。</code></code></pre> </blockquote>

当然要注意我们是在 v1这个分支上来进行 fix,fix 完成后再 merge 到 master 分支上面去,然后发布一个新的版本,遵从语义化的版本规则,我们这里是修正一个 bug,所以只需要添加修正版本号即可,比如命名为 v1.0.1 版本:

<pre><code class="lang-go hljs">$ git add . $ git commit -m "fix Hello function #123" $ git tag v1.0.1 $ git push --tags origin v1</code></code></pre>

这样我们就发布了修正版本的模块了。

<h2>更新 modules</h2>

默认情况下,Golang 不会去自动更新模块的,如果自动更新的话是不是又会造成依赖管理的混乱了,所以我们需要明确告诉 Golang 我们需要更新模块,我们可以通过下面几种方式来进行模块的更新:

<ul><li>

运行 goget-u xxx命令来获取最新的模块(比如我们这里执行的话就会从v1.0.0更新到v1.0.1版本)

</li> <li>

运行 gogetpackage@version命令来更新到指定版本的模块

</li> <li>直接更新 go.mod文件中的模块依赖版本,然后执行 go mod tidy命令来进行更新</li> </ul>

当我们这里用任何一种方式都是可以的,比如用第二种方式:

<pre><code class="lang-go hljs">$ go get github.com/cnych/stardust@v1.0.1</code></code></pre>

更新完成后,可以查看 go.mod文件中的依赖模块的版本变化:

<pre><code class="lang-go hljs">module ch26-gomodules require github.com/cnych/stardust v1.0.1</code></code></pre>

这个时候同样可以查看下 mod 文件夹下面的模块:

<pre><code class="lang-go hljs">$ ls $GOPATH/pkg/mod/github.com/cnych stardust@v1.0.0 stardust@v1.0.1</code></code></pre>

看到这里我们是不是就明白 Go Modules 是通过怎样的方式来进行版本控制的了?每个版本都是独立的文件夹,这样是不是就不会出现版本冲突了。

<h3>主版本升级</h3>

根据语义化版本规则,主版本升级是不向后兼容的,从 Go Modules 的角度来看,主版本是一个完全不同的模块了,因为我们认为两个大版本之间是互相不兼容的,那么我们怎么设计 Go Modules 来支持两个大版本呢?比如现在我们来修改下模块中的 Hello 函数,增加对语言的一个支持:

<pre><code class="lang-go hljs">func Hello(name, lang string) (string, error) { switch lang { case "en": return fmt.Sprintf("Hi, %s!", name), nil case "zh": return fmt.Sprintf("你好, %s!", name), nil case "fr": return fmt.Sprintf("Bonjour, %s!", name), nil default: return "", fmt.Errorf("unknow language") } }</code></code></pre> <blockquote> <pre><code class="lang-go hljs">记住要切换到 master 分支进行修改,因为 v1 分支和我们现在修改的内容是完全不同的版本了。</code></code></pre> </blockquote>

这里我们的函数需要两个参数,返回也是两个参数,直接按照之前 v1 版本中的函数使用肯定是会出错的,所以我们这里新版本的模块就不打算再去兼容之前 1.x 的模块了,这个时候我们需要更新版本到 v2.0.0,那么怎么去区分这两个大版本呢?这个时候我们去更改 v2 版本的模块路径就可以了,比如变成 github.com/cnych/stardust/v2,这样 v2 版本的模块和之前 v1 版本的模块就是两个完全不同的模块了,我们在使用新版本的模块的时候只需要在模块名称后面添加上 v2 就可以了。

<pre><code class="lang-go hljs">module github.com/cnych/stardust/v2</code></code></pre>

接下来和前面的操作一样的,给当前版本添加一个名为 v2.0.0 的 git tag,当然最好还是创建一个名为 v2 的分支,这样可以将版本之间的影响降到最低:

<pre><code class="lang-go hljs">$ git add . $ git commit -m "change Hello function to support lang" $ git checkout -b v2 $ git tag v2.0.0 $ git push origin v2 --tags</code></code></pre>

这样我们 v2 版本的模块就发布成功了,而且之前我们的程序也不会有任何的影响,因为他还是可以继续使用现有的 v1.0.1 版本,而且使用 goget-u命令也不会拉取最新的 v2.0.0 版本代码,但是如果对于使用的用户来说,现在要想使用 v2.0.0 版本的模块怎么办呢?

其实很简单,只需要单独引入 v2 版本的模块即可:

<pre><code class="lang-go hljs">package main import ( "fmt" "github.com/cnych/stardust/stringsx" stringsV2 "github.com/cnych/stardust/v2/stringsx" ) func main() { fmt.Println(stringsx.Hello("cnych")) if greet, err := stringsV2.Hello("cnych", "zh"); err != nil { fmt.Println(err) } else { fmt.Println(greet) } }</code></code></pre>

这个时候我们去执行 go run main.go命令当然同样的会去自动拉取 github.com/cnych/stardust/v2这个模块的代码了:

<pre><code class="lang-go hljs">$ go run main.go go: finding github.com/cnych/stardust/v2 v2.0.0 go: downloading github.com/cnych/stardust/v2 v1.0.0 Hi, cnych!!! 你好, cnych!</code></code></pre>

这样我们在同一个 go 文件中就使用了两个不兼容版本的模块。同样这个时候再次查看下 go.mod文件的变化:

<pre><code class="lang-go hljs">module ch26-gomodules require github.com/cnych/stardust v1.0.1 require github.com/cnych/stardust/v2 v2.0.0</code></code></pre>

默认情况下,Golang 是不会从 go.mod文件中删除依赖项的,如果我们有不使用的一些依赖项需要清理,可以使用 tidy 命令:

<pre><code class="lang-go hljs">$ go mod tidy</code></code></pre>

该命令会清除没有使用的模块,也会更新模块到指定的最新版本。

<h3>Vendor</h3>

Go Modules 默认会忽略 vendor/这个目录,但是如果我们还想将依赖放入 vendor 目录的话,我们可以执行下面的命令:

<pre><code class="lang-go hljs">$ go mod vendor</code></code></pre>

该命令会在项目根目录下面创建一个 vendor/的文件夹,里面会包含所有的依赖模块代码,并且会在该目录下面添加一个名为 modules.txt的文件,用来记录依赖包的一些信息,比较类似于 govendor 中的 vendor.json 文件。

不过建议还是不要使用该命令,尽量去忘掉 vendor 的存在,如果有一些依赖包下载不下来的,我们可以使用 GOPROXY这个参数来设置模块代理,比如:

<pre><code class="lang-go hljs">$ export GOPROXY="https://goproxy.io"</code></code></pre>

阿里云也提供了 Go Modules 代理仓库服务:http://mirrors.aliyun.com/goproxy/,使用很简单就两步:

<ul><li>

1.使用 go1.11 以上版本并开启 go module机制: exportGO111MODULE=on

</li> <li>2.导出GOPROXY环境变量: exportGOPROXY=https://mirrors.aliyun.com/goproxy/</li> </ul>

如果你想上面的配置始终生效,可以将这两条命令添加到 .bashrc中去。

除了使用公有的 Go Modules 代理仓库服务之外,很多时候我们在公司内部需要搭建私有的代理服务,特别是在使用 CI/CD 的时候,如果有一个私有代理仓库服务,会大大的提供应用的构建效率。

我们可以使用Athens来搭建私有的代理仓库服务,搭建非常简单,直接用 docker 镜像运行一个服务即可:

<pre><code class="lang-go hljs">export ATHENS_STORAGE=~/athens-storage mkdir -p $ATHENS_STORAGE docker run -d -v $ATHENS_STORAGE:/var/lib/athens \ -e ATHENS_DISK_STORAGE_ROOT=/var/lib/athens \ -e ATHENS_STORAGE_TYPE=disk \ --name goproxy \ --restart always \ -p 3000:3000 \ gomods/athens:latest</code></code></pre>

其中 ATHENS_STORAGE 是用来存放我们下载下来的模块的本地路径,另外 ATHENS 还支持其他类型的存储,比如 内存, AWS S3 或 Minio,都是 OK 的。

然后修改 GOPROXY 配置:

<pre><code class="lang-go hljs">export GOPROXY=http://127.0.0.1:3000</code></code></pre> <h2>总结</h2>

一句话:Go Modules 真的用起来非常爽,特别是消除了 GOPATH,这个东西对于 Golang 初学者来说是非常烦人的,很难理解为什么需要进入到特定目录下面才可以编写 Go 代码,现在不用担心了,直接使用 GoModules就行。

<h2>参考资料</h2> <ul><li>

https://blog.golang.org/using-go-modules

</li> <li>

https://roberto.selbach.ca/intro-to-go-modules/

</li> <li>https://semver.org/lang/zh-CN/</li> </ul>

全新Golang实战课程上线,课程地址:https://youdianzhishi.com/m/course/1011(点击查看原文了解详细信息)

扫描下面的二维码(或微信搜索 k8s技术圈)关注我们的微信公众帐号,在微信公众帐号中回复 加群 即可加入到我们的 kubernetes 讨论群里面共同学习。

到此这篇关于“ Go Modules 的使用”的文章就介绍到这了,更多文章或继续浏览下面的相关文章,希望大家以后多多支持JQ教程网!

您可能感兴趣的文章:
Go1.13:使用go mod 管理依赖, 提示cannot find module providing package或cannot find main module
Golang从入门到进阶系列:Go Modules机制
GO 依赖管理工具go Modules(官方推荐)
golang的go mod
golang Modules 依赖管理工具使用
Go Modules与GOPROXY 配置
Blog.5 Go Module
go mod使用
04.Go项目布局-你如何设计项目结构
Go Modules 的使用

[关闭]
~ ~