0. 背景介绍
当一个代码仓库进过长时间的迭代,针对不同的时期和需求,必定会有不同的版本。而借助 Git 提供的标签功能,可以快捷方便地记录代码版本。无论什么时候,想取回某个版本,不再需要查找冗长的
commit_id
,只需要取出打标签的历史版本即可。
可以这么理解:标签是版本库的一个快照。在主流的 Git 平台上,版本可以直接下载的,节省了开发者的不少精力。
下面记录下如何借助 标签 进行版本管理。
1. 环境仿真
首先我在 github 上建立了一个仓库。如你所见,这是一个全新仓库:>>> Star now
执行git clone git@github.com:dongyuanxin/git-demos.git
, 将代码库 clone 到本地后。
在根目录下创建一个hello.v1.py
文件:touch hello.v1.py
。代码如下:
# hello.v1.py
print("This is version 1.0")
2. 本地标签操作
下面记录了本地标签操作的常用命令:
命令 | 作用 |
---|---|
git tag |
查看所有标签 |
git tag <tagname> |
创建标签:tagname |
git tag -a <tagname> -m <comment> |
为标签 tagname 增加说明 comment |
git show <tagname> |
查看标签:tagname 的内容 |
git tag -d <tagname> |
删除标签:tagname |
其中,创建标签tagname并且增加说明comment,可以简写成:git tag <tagname> -m <comment>
Now, 为代码库在本地打上标签:git tag v1.0.0 -m 'v1.0.0正式版本'
。
3. 标签的远程推送和拉取
在本地打好标签后,需要将标签推送到Git平台(比如GitHub)上,才能留下版本快照,供别人下载使用。
除此之外,还有可能删除已经发布的标签(比如标签命名不合规范)。
下面记录了远程标签操作的常用命令:
命令 | 作用 |
---|---|
git push origin --tags |
推送所有标签 |
git push origin <tagname> |
推送指定标签 |
我们首先将v1.0.0
版本推送到Github:git push origin v1.0.0
然后,打开仓库,我们会发现releases
标签已经变成了1。
点进去,会发现我们可以直接下载v1.0.0
版本。所以,标签是版本的快照。
值得一提的是:标签会随着git clone
仓库时候,自动拉取到本地。不信的话可以clone一下这个代码仓库,查看是不是已经有了v1.0.0
这个标签。
4. 标签的删除
标签的删除请慎重,尤其是删除远程标签(一般来说,没有人会这么做)。命令如下:
命令 | 作用 |
---|---|
git tag -d <tagname> |
删除指定标签 |
git push origin :refs/tags/<tagname> |
删除远程标签 |
5. 拓展阅读
版本管理可以借助git的tag来实现。但是,在开发过程中,不可能每次修改都打标签然后发布。
实际开发中,一般会有一个dev
分支,作为开发版本分支。在没有完成此次开发任务前,所有的代码都是合并到dev
分支。
当完成了开发任务,管理者会将dev
分支合并到master
分支,然后删除dev
分支,并且通过打标签来发布版本。
这就是为什么很多放弃维护的大型开源项目只有master
分支的原因。