在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
更直观(方便交流与比较版本大小),所以一般情况下使用语义化版本。
什么是伪版本
在实际项目中,有时不得不直接使用一个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.0
,go
命令生成伪版本号时自动增加了版本。此时,如果存在go.mod
文件的话,github.com/renhongcai/gomodule
体现在go.mod
文件中的版本则为该伪版本号。
赠人玫瑰手留余香,如果觉得不错请给个赞~
本篇文章已归档到GitHub项目,求星~ 点我即达