Git技能树(6):Git标签
发布一个版本时,我们通常先在版本库中打一个标签(tag
),这样,就唯一确定了打标签时刻的版本。将来无论什么时候,取某个标签的版本,就是把那个打标签的时刻的历史版本取出来。所以,标签也是版本库的一个快照。
Git 的标签虽然是版本库的快照,但其实它就是指向某个commit
的指针(跟分支很像对不对?但是分支可以移动,标签不能移动),所以,创建和删除标签都是瞬间完成的。
Git 有commit
,为什么还要引入tag
?
“请把上周一的那个版本打包发布,commit号是6a5819e…”
“一串乱七八糟的数字不好找!”
如果换一个办法:
“请把上周一的那个版本打包发布,版本号是v1
.2”
“好的,按照tag v1
.2查找commit
就行!”
所以,tag
就是一个让人容易记住的有意义的名字,它跟某个commit
绑在一起。
创建标签
在 Git
中创建标签非常简单,首先,切换到需要打标签的分支上:
$ git branch * dev master $ git checkout master Switched to branch 'master'
然后,敲命令git tag <name>
就可以打一个新标签:
$ git tag v1.0
可以用命令git tag
查看所有标签:
$ git tag v1.0
默认标签是打在最新提交的commit
上的。有时候,如果忘了打标签,比如,现在已经是周五了,但应该在周一打的标签没有打,怎么办?
方法是找到历史提交的commit id
,然后打上就可以了:
$ git log --pretty=oneline --abbrev-commit 5c7e5ea (HEAD -> master) remove test.txt c67077f add test.txt fb8b190 conflict fixed 06e5e3a & simple 2443c95 add simple 4aac6c7 branch test 599dbdb understand how stage works 1985ccf append GPL 27f9df6 add distributed e372504 wrote a readme file
比方说要对conflict fixed
这次提交打标签,它对应的commit id
是fb8b190
,敲入命令:
$ git tag v0.9 fb8b190
再用命令git tag
查看标签:
$ git tag v0.9 v1.0
注意,标签不是按时间顺序列出,而是按字母排序的。可以用git show
查看标签信息:
$ git show v0.9 commit fb8b1903706eeaa8141894f1af859f0dfee3e0d9 (tag: v0.9) Merge: 06e5e3a 2443c95 Author: Miykael_xxm <xiongjiamu@gmail.com> Date: Sun Nov 29 20:18:26 2020 +0800 conflict fixed (END)
可以看到,v0.9确实打在conflict fixed
这次提交上。
还可以创建带有说明的标签,用-a
指定标签名,-m
指定说明文字:
$ git tag -a v0.1 -m "version 0.1 released" 1985ccf
用命令git show <tagname>
可以看到说明文字:
$ git show v0.1 tag v0.1 Tagger: Miykael_xxm <xiongjiamu@gmail.com> Date: Sun Nov 29 22:06:05 2020 +0800 version 0.1 released commit 1985ccf5b6710edf3bcd7c0700e6d96cab335e61 (tag: v0.1, tag: remove) Author: Miykael_xxm <xiongjiamu@gmail.com> Date: Fri Nov 27 16:14:27 2020 +0800 append GPL diff --git a/readme.txt b/readme.txt index 9247db6..8443d23 100644 --- a/readme.txt +++ b/readme.txt @@ -1,2 +1,2 @@ Git is a distributed version control system. -Git is free software. +Git is free software distributed under the GPL. (END)
注意:标签总是和某个
commit
挂钩。如果这个commit
既出现在master
分支,又出现在dev
分支,那么在这两个分支上都可以看到这个标签。
标签操作
如果标签打错了,也可以删除:
$ git tag -d v0.1 Deleted tag 'v0.1' (was 3be0bf5)
因为创建的标签都只存储在本地,不会自动推送到远程。所以,打错的标签可以在本地安全删除。
如果要推送某个标签到远程,使用命令git push origin <tagname>
:
$ git push origin v1.0 Total 0 (delta 0), reused 0 (delta 0), pack-reused 0 To gitcode.net:xiongjiamu/learing.git * [new tag] v1.0 -> v1.0
或者,一次性推送全部尚未推送到远程的本地标签:
$ git push origin --tags Enumerating objects: 1, done. Counting objects: 100% (1/1), done. Writing objects: 100% (1/1), 170 bytes | 170.00 KiB/s, done. Total 1 (delta 0), reused 0 (delta 0), pack-reused 0 To gitcode.net:xiongjiamu/learing.git * [new tag] remove -> remove * [new tag] v0.1 -> v0.1 * [new tag] v0.9 -> v0.9
如果标签已经推送到远程,要删除远程标签就麻烦一点,先从本地删除:
$ git tag -d remove Deleted tag 'remove' (was 1985ccf)
然后,从远程删除。删除命令也是push
,但是格式如下:
$ git push origin :refs/tags/remove To gitcode.net:xiongjiamu/learing.git - [deleted] remove
要看看是否真的从远程库删除了标签,可以登录 GIT CODE
上查看。
小结
以上就是 git tag
操作的内容介绍了,现在让我们来回顾一下:
- 命令
git push origin <tagname>
可以推送一个本地标签; - 命令
git push origin --tags
可以推送全部未推送过的本地标签; - 命令
git tag -d <tagname>
可以删除一个本地标签; - 命令
git push origin :refs/tags/<tagname>
可以删除一个远程标签 - 命令
git tag -a <tagname> -m 'messages'
可以创建一个带附注的标签 - 命令
git tag -s <tagname> -m 'messages'
可以创建一个带gpg
签名的标签