1.简介
在go.mod中通常使用语义化版本来标记依赖,比如v1.2.3
、v0.1.5
等。因为go.mod文件通常是go命令自动生成并修改的,所以实际上是go命令习惯使用语义化版本。
诸如v1.2.3
和v0.1.5
这样的语义化版本,实际是某个commit ID的标记,真正的版本还是commit ID。
比如github.com/renhongcai/gomodule
项目的v1.5.0
对应的真实版本为20e9757b072283e5f57be41405fe7aaf867db220
。
由于语义化版本比commit ID
更直观(方便交流与比较版本大小),所以一般情况下使用语义化版本。
2. 什么是伪版本
在实际项目中,有时不得不直接使用一个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
)
...
3. 伪版本风格
伪版本格式都为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命令会帮我们自动生成伪版本,不需要手动计算,所以此处仅做基本说明。
4. 如何获取伪版本
使用具体的例子还演示如何使用伪版本。在仓库github.com/renhongcai/gomodule
中存在v1.5.0
tag 版本,在v1.5.0之后又提交了一个commit,并没有发布新的版本。其版本示意图如下:
为了方便描述,我们把1.5.0
对应的commit 称为commit-A
,而其随后的commit称为commit-B
。
如果我们要使用commit-A,即v1.5.0,可使用go get github.com/renhongcai/gomodule@v1.5.0
命令:
[root@wsl-maoyifei ~]# 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@wsl-maoyifei ~]# 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.0
,go命令生成伪版本号时自动增加了版本。此时,如果存在go.mod文件的话,github.com/renhongcai/gomodule
体现在go.mod文件中的版本则为该伪版本号。