發布一個版本時,我們通常先在版本庫中打一個標簽(tag),這樣,就唯一確定了打標簽時刻的版本。將來無論什么時候,取某個標簽的版本,就是把那個打標簽的時刻的歷史版本取出來。所以,標簽也是版本庫的一個快照。
Git的標簽雖然是版本庫的快照,但其實它就是指向某個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 6a5819e merged bug fix 101 cc17032 fix bug 101 7825a50 merge with no-ff 6224937 add merge 59bc1cb conflict fixed 400b400 & simple 75a857c AND simple fec145a branch test d17efd8 remove test.txt ...
比方說要對add merge
這次提交打標簽,它對應的commit id是6224937
,敲入命令:
$ git tag v0.9 6224937
再用命令git tag
查看標簽:
$ git tag v0.9 v1.0
注意,標簽不是按時間順序列出,而是按字母排序的。可以用git show <tagname>
查看標簽信息:
$ git show v0.9 commit 622493706ab447b6bb37e4e2a2f276a20fed2ab4 Author: Michael Liao <askxuefeng@gmail.com> Date: Thu Aug 22 11:22:08 2013 +0800 add merge ...
可以看到,v0.9
確實打在add merge
這次提交上。
還可以創建帶有說明的標簽,用-a
指定標簽名,-m
指定說明文字:
$ git tag -a v0.1 -m "version 0.1 released" 3628164
用命令git show <tagname>
可以看到說明文字:
$ git show v0.1
tag v0.1
Tagger: Michael Liao <askxuefeng@gmail.com> Date: Mon Aug 26 07:28:11 2013 +0800 version 0.1 released commit 3628164fb26d48395383f8f31179f24e0882e1e0 Author: Michael Liao <askxuefeng@gmail.com> Date: Tue Aug 20 15:11:49 2013 +0800 append GPL
還可以通過-s
用私鑰簽名一個標簽:
$ git tag -s v0.2 -m "signed version 0.2 released" fec145a
簽名采用PGP簽名,因此,必須首先安裝gpg(GnuPG),如果沒有找到gpg,或者沒有gpg密鑰對,就會報錯:
gpg: signing failed: secret key not available error: gpg failed to sign the data error: unable to sign the tag
如果報錯,請參考GnuPG幫助文檔配置Key。
用命令git show <tagname>
可以看到PGP簽名信息:
$ git show v0.2
如果標簽打錯了,也可以刪除:
$ git tag -d v0.1 Deleted tag 'v0.1' (was e078af9)
因為創建的標簽都只存儲在本地,不會自動推送到遠程。所以,打錯的標簽可以在本地安全刪除。
如果要推送某個標簽到遠程,使用命令git push origin <tagname>
:
$ git push origin v1.0 Total 0 (delta 0), reused 0 (delta 0) To git@github.com:michaelliao/learngit.git * [new tag] v1.0 -> v1.0
或者,一次性推送全部尚未推送到遠程的本地標簽:
$ git push origin --tags
如果標簽已經推送到遠程,要刪除遠程標簽就麻煩一點,先從本地刪除:
$ git tag -d v0.9 Deleted tag 'v0.9' (was 6224937)
然后,從遠程刪除。刪除命令也是push,但是格式如下:
$ git push origin :refs/tags/v0.9 To git@github.com:michaelliao/learngit.git - [deleted] v0.9
要看看是否真的從遠程庫刪除了標簽,可以登陸GitHub查看。
小結
-
命令
git tag <name>
用於新建一個標簽,默認為HEAD
,也可以指定一個commit id; -
git tag -a <tagname> -m "blablabla..."
可以指定標簽信息; -
git tag -s <tagname> -m "blablabla..."
可以用PGP簽名標簽; -
命令
git tag
可以查看所有標簽。 -
命令
git push origin <tagname>
可以推送一個本地標簽; -
命令
git push origin --tags
可以推送全部未推送過的本地標簽; -
命令
git tag -d <tagname>
可以刪除一個本地標簽; - 命令
git push origin :refs/tags/<tagname>
可以刪除一個遠程標簽。