發布一個版本時,我們通常先在版本庫中打一個標籤(tag),這樣,就唯一確定了打標籤時刻的版本。將來無論什麼時候,取某個標籤的版本,就是把那個打標籤的時刻的曆史版本取出來。所以,標籤也是版本庫的一個快照。
Git的標籤雖然是版本庫的快照,但其實它就是指向某個commit的指標(跟分支很像對不對。但是分支可以移動,標籤不能移動),所以,建立和刪除標籤都是瞬間完成的。
Git有commit,為什麼還要引入tag。
“請把上周一的那個版本打包發布,commit號是6a5819e...”
“一串亂七八糟的數字不好找。”
如果換一個辦法:
“請把上周一的那個版本打包發布,版本號碼是v1.2”
“好的,按照tag v1.2尋找commit就行。”
所以,tag就是一個讓人容易記住的有意義的名字,它跟某個commit綁在一起。 1:建立標籤
在Git中打標籤非常簡單,首先,切換到需要打標籤的分支上:
$ git branch* dev master$ git checkout masterSwitched to branch 'master'
然後,敲命令git tag <name>就可以打一個新標籤:
$ git tag v1.0
可以用命令git tag查看所有標籤:
$ git tagv1.0
預設標籤是打在最新提交的commit上的。有時候,如果忘了打標籤,比如,現在已經是周五了,但應該在周一打的標籤沒有打,怎麼辦。
方法是找到曆史提交的commit id,然後打上就可以了:
$ git log --pretty=oneline --abbrev-commit6a5819e merged bug fix 101cc17032 fix bug 1017825a50 merge with no-ff6224937 add merge59bc1cb conflict fixed400b400 & simple75a857c AND simplefec145a branch testd17efd8 remove test.txt...
比方說要對add merge這次提交打標籤,它對應的commit id是6224937,敲入命令:
$ git tag v0.9 6224937
再用命令git tag查看標籤:
$ git tagv0.9v1.0
注意,標籤不是按時間順序列出,而是按字母排序的。可以用git show <tagname>查看標籤資訊:
$ git show v0.9commit 622493706ab447b6bb37e4e2a2f276a20fed2ab4Author: 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.1tag v0.1Tagger: Michael Liao <askxuefeng@gmail.com>Date: Mon Aug 26 07:28:11 2013 +0800version 0.1 releasedcommit 3628164fb26d48395383f8f31179f24e0882e1e0Author: 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 availableerror: gpg failed to sign the dataerror: unable to sign the tag
如果報錯,請參考GnuPG協助文檔配置Key。
用命令git show <tagname>可以看到PGP簽名資訊:
$ git show v0.2tag v0.2Tagger: Michael Liao <askxuefeng@gmail.com>Date: Mon Aug 26 07:28:33 2013 +0800signed version 0.2 released-----BEGIN PGP SIGNATURE-----Version: GnuPG v1.4.12 (Darwin)iQEcBAABAgAGBQJSGpMhAAoJEPUxHyDAhBpT4QQIAKeHfR3bo...-----END PGP SIGNATURE-----commit fec145accd63cdc9ed95a2f557ea0658a2a6537fAuthor: Michael Liao <askxuefeng@gmail.com>Date: Thu Aug 22 10:37:30 2013 +0800 branch test
用PGP簽名的標籤是不可偽造的,因為可以驗證PGP簽名。驗證簽名的方法比較複雜,這裡就不介紹了。 小結
命令git tag <name>用於建立一個標籤,預設為HEAD,也可以指定一個commit id;
git tag -a <tagname> -m "blablabla..."可以指定標籤資訊;
git tag -s <tagname> -m "blablabla..."可以用PGP簽名標籤;
命令git tag可以查看所有標籤。 2:操作標籤
如果標籤打錯了,也可以刪除:
$ git tag -d v0.1Deleted tag 'v0.1' (was e078af9)
因為建立的標籤都只儲存在本地,不會自動推送到遠程。所以,打錯的標籤可以在本地安全刪除。
如果要推送某個標籤到遠程,使用命令git push origin <tagname>:
$ git push origin v1.0Total 0 (delta 0), reused 0 (delta 0)To git@github.com:michaelliao/learngit.git * [new tag] v1.0 -> v1.0
或者,一次性推送全部尚未推送到遠端本地標籤:
$ git push origin --tagsCounting objects: 1, done.Writing objects: 100% (1/1), 554 bytes, done.Total 1 (delta 0), reused 0 (delta 0)To git@github.com:michaelliao/learngit.git * [new tag] v0.2 -> v0.2 * [new tag] v0.9 -> v0.9
如果標籤已經推送到遠程,要刪除遠程標籤就麻煩一點,先從本地刪除:
$ git tag -d v0.9Deleted tag 'v0.9' (was 6224937)
然後,從遠程刪除。刪除命令也是push,但是格式如下:
$ git push origin :refs/tags/v0.9To git@github.com:michaelliao/learngit.git - [deleted] v0.9
要看看是否真的從遠程庫刪除了標籤,可以登陸GitHub查看。 小結
命令git push origin <tagname>可以推送一個本地標籤;
命令git push origin --tags可以推送全部未推送過的本地標籤;
命令git tag -d <tagname>可以刪除一個本地標籤;
命令git push origin :refs/tags/<tagname>可以刪除一個遠程標籤。