tag
标签介绍
发布一个版本时,我们通常先在版本库中打一个标签(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
ffbc3a5 merged bug fix 101
eebe0ce fix bug 101
dc0fa98 merge with no-ff
1c2c8d5 add merge
519b239 conflict fixed
cdd45fe & simple
019672b AND simple
6637024 branch test
27470e0 First Commit
edf0b59 Initial commit
比方说要对add merge
这次提交打标签,它对应的commit id
是1c2c8d5
,敲入命令
$ git tag v0.9 1c2c8d5
再用命令git tag
查看标签:
$ git tag
v0.9
v1.0
注意,标签不是按时间顺序列出,而是按字母排序的。可以用git show <tagname>
查看标签信息:
$ git show v0.9
commit 1c2c8d5355dd8aaf8b7c88bcf9e8262c60b18691
Author: Errol<944932343@qq.com>
Date: Wed Jan 9 13:17:09 2019 +0800
add merge
diff --git a/readme.txt b/readme.txt
index ea69c1a..6177563 100644
--- a/readme.txt
+++ b/readme.txt
@@ -1,5 +1,6 @@
+Edit on dev Branch.
Git is a distributed version control system.
Git is free software distributed under the GPL.
Git has a mutable index called stage.
Git tracks changes.
-Creating a new branch is quick and simple.
+Creating a new branch is quick and simple.
\ No newline at end of file
可以看到,v0.9
确实打在add merge
这次提交上。
还可以创建带有说明的标签,用 -a
指定标签名,-m
指定说明文字:
$ git tag -a v0.1 -m "version 0.1 released" 27470e0
用命令git show <tagname>
可以看到说明文字:
$ git show v0.1
tag v0.1
Tagger: Errol<944932343@qq.com>
Date: Wed Jan 23 14:05:44 2019 +0800
version 0.1 released
commit 27470e0fd6d964475e2637b2b7ecd3a2d38669fa
Author: lixiaowei <944932343@qq.com>
Date: Mon Jan 7 18:16:47 2019 +0800
First Commit
diff --git a/readme.txt b/readme.txt
new file mode 100644
index 0000000..db28b2c
......
注意:标签总是和某个commit挂钩。如果这个commit既出现在master分支,又出现在dev分支,那么在这两个分支上都可以看到这个标签。
删除标签
如果标签打错了可以删除
$ git tag -d v0.1
Deleted tag 'v0.1' (was 725c4dd)
因为创建的标签都只存储在本地,不会自动推送到远程。所以,打错的标签可以在本地安全删除。
如果要推送某个标签到远程,使用命令git push origin <tagname>
:
$ git push origin v1.0
Total 0 (delta 0), reused 0 (delta 0)
To github.com:944932343/gitskills.git
* [new tag] v1.0 -> v1.0
或者,一次性推送全部尚未推送到远程的本地标签:
$ git push origin --tags
Total 0 (delta 0), reused 0 (delta 0)
To github.com:944932343/gitskills.git
* [new tag] v0.9 -> v0.9
我们可以登录github查看一下这些tag,打开gitskills项目,点击releases
切换到tag,可以查看tag
如果标签已经推送到远程,要删除远程标签就麻烦一点,先从本地删除:
$ git tag -d v0.9
Deleted tag 'v0.9' (was 1c2c8d5)
然后,从远程删除。删除命令也是push,但是格式如下:
$ git push origin :refs/tags/v0.9
To github.com:944932343/gitskills.git
- [deleted] v0.9
再查看tag,已经木有v0.9了
小结
新建标签很简单,首先切换到要打标签的分支上,然后用命令git tag 用于新建一个标签,默认为HEAD,默认标签是打在最新提交的commit上的
也可以指定一个commit id,$ git tag <tagname> <commit id>
命令git tag -a <tagname> -m "blablabla..."
可以指定标签信息;
命令git tag
可以查看所有标签
命令git show <tagname>
查看某一标签信息
命令git -d <tagname>
可以删除一个标签
命令git push origin <tagname>
可以将本地标签推送到远程(创建的标签都只存储在本地,不会自动推送到远程)
一次性推送全部尚未推送到远程的本地标签:git push origin --tags
删除远程tag,要分2步,首先删除本地taggit -d <tagname>
,然后从远程删除git push origin :refs/tags/<tagname>