git tag 打標簽 標簽管理 刪標簽 等操作匯總

像其他版本控制系統(VCS)一樣,Git 可以給倉庫歷史中的某一個提交打上標簽,以示重要。 比較有代表性的是人們會使用這個功能來標記發布結點( v1.0 、 v2.0 等等)。 在本節中,你將會學習如何列出已有的標簽、如何創建和刪除新的標簽、以及不同類型的標簽分別是什么。

補充:有很多新手對標簽和分支有點云里霧里的,會誤認為每個標簽有它對應的是分支,其實標簽對應的是head版本指針所對應的commit也即快照,也就是說你在某一個分支上打了一個標簽,再切到另外的分支上去,這個標簽還是存在的,只是對應的是這個標簽之前的commit,相當于是一個時間快照,他可以橫跨標簽,所以這就是它的靈活性

**

介紹幾個常用的git打tag的命令,

**

1、查看所有標簽
在 Git 中列出已有的標簽非常簡單,只需要輸入 git tag (可帶上可選的 -l 選項 --list):

//查看所有標簽的命令
$ git tag 
v1.0
v2.0

這個命令以字母順序列出標簽,但是它們顯示的順序并不重要。
2、查看標簽和它的備注

git tag -l -n

3、查看線上代碼庫的標簽

git ls-remote --tags

4、查看具體某一個標簽

你也可以按照特定的模式查找標簽。 例如,Git 自身的源代碼倉庫包含標簽的數量超過 500 個。 如果只對 1.8.5 系列感興趣,可以運行:

$ git tag -l "v1.8.5*"
v1.8.5
v1.8.5-rc0
v1.8.5-rc1
v1.8.5-rc2
v1.8.5-rc3
v1.8.5.1
v1.8.5.2
v1.8.5.3
v1.8.5.4
v1.8.5.5
Note

按照通配符列出標簽需要 -l 或 --list 選項
如果你只想要完整的標簽列表,那么運行 git tag 就會默認假定你想要一個列表,它會直接給你列出來, 此時的 -l 或 --list 是可選的。

然而,如果你提供了一個匹配標簽名的通配模式,那么 -l 或 --list 就是強制使用的。

**

創建標簽

**
Git 支持兩種標簽:輕量標簽(lightweight)與附注標簽(annotated)

輕量標簽很像一個不會改變的分支——它只是某個特定提交的引用。

而附注標簽是存儲在 Git 數據庫中的一個完整對象, 它們是可以被校驗的,其中包含打標簽者的名字、電子郵件地址、日期時間, 此外還有一個標簽信息,并且可以使用 GNU Privacy Guard (GPG)簽名并驗證。 通常會建議創建附注標簽,這樣你可以擁有以上所有信息。但是如果你只是想用一個臨時的標簽, 或者因為某些原因不想要保存這些信息,那么也可以用輕量標簽。

附注標簽
在 Git 中創建附注標簽十分簡單。 最簡單的方式是當你在運行 tag 命令時指定 -a 選項:

$ git tag -a v1.4 -m "my version 1.4"
$ git tag
v0.1
v1.3
v1.4

-m 選項指定了一條將會存儲在標簽中的信息。 如果沒有為附注標簽指定一條信息,Git 會啟動編輯器要求你輸入信息。

*通過使用 git show 命令可以看到標簽信息和與之對應的提交信息*:

$ git show v1.4
tag v1.4
Tagger: Ben Straub <ben@straub.cc>
Date:   Sat May 3 20:19:12 2014 -0700

my version 1.4

commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Mar 17 21:52:11 2008 -0700

輸出顯示了打標簽者的信息、打標簽的日期時間、附注信息,然后顯示具體的提交信息。

輕量標簽
另一種給提交打標簽的方式是使用輕量標簽。 輕量標簽本質上是將提交校驗和存儲到一個文件中——沒有保存任何其他信息。 創建輕量標簽,不需要使用 -a、-s 或 -m 選項,只需要提供標簽名字:

$ git tag v1.4-lw
$ git tag
v0.1
v1.3
v1.4
v1.4-lw
v1.5

這時,如果在標簽上運行 git show,你不會看到額外的標簽信息。 命令只會顯示出提交信息:

$ git show v1.4-lw
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Mar 17 21:52:11 2008 -0700

changed the version number

后期打標簽
你也可以對過去的提交打標簽。 假設提交歷史是這樣的:

$ git log --pretty=oneline
15027957951b64cf874c3557a0f3547bd83b3ff6 Merge branch 'experiment'
a6b4c97498bd301d84096da251c98a07c7723e65 beginning write support
0d52aaab4479697da7686c15f77a3d64d9165190 one more thing
6d52a271eda8725415634dd79daabbc4d9b6008e Merge branch 'experiment'
0b7434d86859cc7b8c3d5e1dddfed66ff742fcbc added a commit function
4682c3261057305bdd616e23b64b0857d832627b added a todo file
166ae0c4d3f420721acbb115cc33848dfcc2121a started write support
9fceb02d0ae598e95dc970b74767f19372d61af8 updated rakefile
964f16d36dfccde844893cac5b347e7b3d44abbc commit the todo
8a5cbc430f1a9c3d00faaeffd07798508422908a updated readme

現在,假設在 v1.2 時你忘記給項目打標簽,也就是在 “updated rakefile” 提交。 你可以在之后補上標簽。 要在那個提交上打標簽,你需要在命令的末尾指定提交的校驗和(或部分校驗和):

$ git tag -a v1.2 9fceb02

可以看到你已經在那次提交上打上標簽了:

$ git tag
v0.1
v1.2
v1.3
v1.4
v1.4-lw
v1.5

$ git show v1.2
tag v1.2
Tagger: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Feb 9 15:32:16 2009 -0800

version 1.2
commit 9fceb02d0ae598e95dc970b74767f19372d61af8
Author: Magnus Chacon <mchacon@gee-mail.com>
Date:   Sun Apr 27 20:43:35 2008 -0700

    updated rakefile
...

共享標簽(其實就是將標簽推到先上去)
默認情況下,git push 命令并不會傳送標簽到遠程倉庫服務器上。 在創建完標簽后你必須顯式地推送標簽到共享服務器上。 這個過程就像共享遠程分支一樣——你可以運行 git push origin 。

$ git push origin v1.5
Counting objects: 14, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (12/12), done.
Writing objects: 100% (14/14), 2.05 KiB | 0 bytes/s, done.
Total 14 (delta 3), reused 0 (delta 0)
To git@github.com:schacon/simplegit.git
 * [new tag]         v1.5 -> v1.5

如果想要一次性推送很多標簽,也可以使用帶有 --tags 選項的 git push 命令。 這將會把所有不在遠程倉庫服務器上的標簽全部傳送到那里。

$ git push origin --tags
Counting objects: 1, done.
Writing objects: 100% (1/1), 160 bytes | 0 bytes/s, done.
Total 1 (delta 0), reused 0 (delta 0)
To git@github.com:schacon/simplegit.git
 * [new tag]         v1.4 -> v1.4
 * [new tag]         v1.4-lw -> v1.4-lw

現在,當其他人從倉庫中克隆或拉取,他們也能得到你的那些標簽。

git push 推送兩種標簽

使用 git push <remote> --tags 推送標簽并不會區分輕量標簽和附注標簽, 沒有簡單的選項能夠讓你只選擇推送一種標簽。

刪除標簽
要刪除掉你本地倉庫上的標簽,可以使用命令 git tag -d <tagname>。 例如,可以使用以下命令刪除一個輕量標簽:

$ git tag -d v1.4-lw
Deleted tag 'v1.4-lw' (was e7d5add)

注意上述命令并不會從任何遠程倉庫中移除這個標簽,你必須用 git push <remote> :refs/tags/<tagname> 來更新你的遠程倉庫:

第一種變體是 git push <remote> :refs/tags/<tagname> :

$ git push origin :refs/tags/v1.4-lw
To /git@github.com:schacon/simplegit.git
 - [deleted]         v1.4-lw

上面這種操作的含義是,將冒號前面的空值推送到遠程標簽名,從而高效地刪除它。

第二種更直觀的刪除遠程標簽的方式是:

$ git push origin --delete <tagname>

·檢出標簽·
如果你想查看某個標簽所指向的文件版本,可以使用 git checkout 命令, 雖然這會使你的倉庫處于“分離頭指針(detached HEAD)”的狀態——這個狀態有些不好的副作用:

$ git checkout 2.0.0
Note: checking out '2.0.0'.

You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches by performing another checkout.

If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -b with the checkout command again. Example:

  git checkout -b <new-branch>

HEAD is now at 99ada87... Merge pull request #89 from schacon/appendix-final

$ git checkout 2.0-beta-0.1
Previous HEAD position was 99ada87... Merge pull request #89 from schacon/appendix-final
HEAD is now at df3f601... add atlas.json and cover image

在“分離頭指針”狀態下,如果你做了某些更改然后提交它們,標簽不會發生變化, 但你的新提交將不屬于任何分支,并且將無法訪問,除非通過確切的提交哈希才能訪問。 因此,如果你需要進行更改,比如你要修復舊版本中的錯誤,那么通常需要創建一個新分支:

$ git checkout -b version2 v2.0.0
Switched to a new branch 'version2'

如果在這之后又進行了一次提交,version2 分支就會因為這個改動向前移動, 此時它就會和 v2.0.0 標簽稍微有些不同,這時就要當心了。

?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,505評論 6 533
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,556評論 3 418
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,463評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,009評論 1 312
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,778評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,218評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,281評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,436評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,969評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,795評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,993評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,537評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,229評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,659評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,917評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,687評論 3 392
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,990評論 2 374

推薦閱讀更多精彩內容