go.mod中通常使用语义化版本来标记依赖,比如v1.2.3v0.1.5等。因为go.mod文件通常是go命令自动生成并修改的,所以实际上是go命令习惯使用语义化版本。

诸如v1.2.3v0.1.5这样的语义化版本,实际是某个commit ID的标记,真正的版本还是commit ID。比如github.com/renhongcai/gomodule项目的v1.5.0对应的真实版本为20e9757b072283e5f57be41405fe7aaf867db220

由于语义化版本比commit ID更直观(方便交流与比较版本大小),所以一般情况下使用语义化版本。

什么是伪版本

在实际项目中,有时不得不直接使用一个commit ID,比如某项目发布了v1.5.0版本,但随即又修复了一个bug(引入一个新的commit ID),而且没有发布新的版本。此时,如果我们希望使用最新的版本,就需要直接引用最新的commit ID,而不是之前的语义化版本v1.5.0
使用commit ID的版本在Go语言中称为pseudo-version,可译为”伪版本”。

伪版本的版本号通常会使用vx.y.z-yyyymmddhhmmss-abcdefabcdef格式,其中vx.y.z看上去像是一个真实的语义化版本,但通常并不存在该版本,所以称为伪版本。另外abcdefabcdef表示某个commit ID的前12位,而yyyymmddhhmmss则表示该commit的提交时间,方便做版本比较。

使用伪版本的go.mod举例如下:

...
require (
    go.etcd.io/etcd v0.0.0-20191023171146-3cf2f69b5738
)
...

伪版本风格

伪版本格式都为vx.y.z-yyyymmddhhmmss-abcdefabcdef,但vx.y.z部分在不同情况下略有区别,有时可能是vx.y.z-pre.0或者vx.y.z-0,甚至vx.y.z-dev.2.0等。

vx.y.z的具体格式取决于所引用commit ID之前的版本号,如果所引用commit ID之前的最新的tag版本为v1.5.0,那么伪版本号则在其基础上增加一个标记,即v1.5.1-0,看上去像是下一个版本一样。

实际使用中go命令会帮我们自动生成伪版本,不需要手动计算,所以此处我们仅做基本说明。

如何获取伪版本

我们使用具体的例子还演示如何使用伪版本。在仓库github.com/renhongcai/gomodule中存在v1.5.0 tag 版本,在v1.5.0之后又提交了一个commit,并没有发布新的版本。其版本示意图如下:

为了方便描述,我们把v1.5.0对应的commit 称为commit-A,而其随后的commit称为commit-B

如果我们要使用commit-A,即v1.5.0,可使用go get github.com/renhongcai/gomodule@v1.5.0命令:

[root@ecs-d8b6 ~]# go get github.com/renhongcai/gomodule@v1.5.0
go: finding github.com/renhongcai/gomodule v1.5.0
go: downloading github.com/renhongcai/gomodule v1.5.0
go: extracting github.com/renhongcai/gomodule v1.5.0
go: finding github.com/renhongcai/indirect v1.0.1

此时,如果存在go.mod文件,github.com/renhongcai/gomodule体现在go.mod文件的版本为v1.5.0

如果我们要使用commit-B,可使用go get github.com/renhongcai/gomodule@6eb27062747a458a27fb05fceff6e3175e5eca95命令(可以使用完整的commit id,也可以只使用前12位):

[root@ecs-d8b6 ~]# go get github.com/renhongcai/gomodule@6eb27062747a458a27fb05fceff6e3175e5eca95
go: finding github.com 6eb27062747a458a27fb05fceff6e3175e5eca95
go: finding github.com/renhongcai/gomodule 6eb27062747a458a27fb05fceff6e3175e5eca95
go: finding github.com/renhongcai 6eb27062747a458a27fb05fceff6e3175e5eca95
go: downloading github.com/renhongcai/gomodule v1.5.1-0.20200203082525-6eb27062747a
go: extracting github.com/renhongcai/gomodule v1.5.1-0.20200203082525-6eb27062747a
go: finding github.com/renhongcai/indirect v1.0.2

此时,可以看到生成的伪版本号为v1.5.1-0.20200203082525-6eb27062747a,当前最新版本为v1.5.0go命令生成伪版本号时自动增加了版本。此时,如果存在go.mod文件的话,github.com/renhongcai/gomodule体现在go.mod文件中的版本则为该伪版本号。

赠人玫瑰手留余香,如果觉得不错请给个赞~

本篇文章已归档到GitHub项目,求星~ 点我即达

文档更新时间: 2020-08-08 22:03   作者:kuteng