Git (10)-- 打標(biāo)簽(git tag)

@[TOC]

超詳細(xì) Git 圖文版小白教程(持續(xù)更新)

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

1、列出標(biāo)簽

Git 中列出已有的標(biāo)簽非常簡單,只需要輸入 git tag (可帶上可選的 -l 選項(xiàng) --list):

在這里插入圖片描述

我這個倉庫還沒有推送過標(biāo)簽,所以顯示為空。
這個命令以字母順序列出標(biāo)簽,但是它們顯示的順序并不重要。

看一下git源碼庫的標(biāo)簽:

在這里插入圖片描述

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

在這里插入圖片描述

按照通配符列出標(biāo)簽需要 -l--list 選項(xiàng):

如果你只想要完整的標(biāo)簽列表,那么運(yùn)行 git tag 就會默認(rèn)假定你想要一個列表,它會直接給你列出來, 此時的 -l--list是可選的。

然而,如果你提供了一個匹配標(biāo)簽名的通配模式,那么 -l--list 就是強(qiáng)制使用的。

2、創(chuàng)建標(biāo)簽

Git 支持兩種標(biāo)簽:輕量標(biāo)簽(lightweight)與附注標(biāo)簽(annotated)。

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

而附注標(biāo)簽是存儲在 Git 數(shù)據(jù)庫中的一個完整對象, 它們是可以被校驗(yàn)的,其中包含打標(biāo)簽者的名字、電子郵件地址、日期時間, 此外還有一個標(biāo)簽信息,并且可以使用 GNU Privacy Guard (GPG)簽名并驗(yàn)證。 通常會建議創(chuàng)建附注標(biāo)簽,這樣你可以擁有以上所有信息。但是如果你只是想用一個臨時的標(biāo)簽, 或者因?yàn)槟承┰虿幌胍4孢@些信息,那么也可以用輕量標(biāo)簽。

2.1、附注標(biāo)簽

Git 中創(chuàng)建附注標(biāo)簽十分簡單。 最簡單的方式是當(dāng)你在運(yùn)行 tag 命令時指定 -a 選項(xiàng):

在這里插入圖片描述

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

通過使用 git show 命令可以看到標(biāo)簽信息和與之對應(yīng)的提交信息:

在這里插入圖片描述

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

2.2、輕量標(biāo)簽

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

在這里插入圖片描述

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

在這里插入圖片描述

3、后期打標(biāo)簽

你也可以對過去的提交打標(biāo)簽。 假設(shè)提交歷史是這樣的:

在這里插入圖片描述

現(xiàn)在,假設(shè)在 v1.0 時你忘記給項(xiàng)目打標(biāo)簽,也就是在 “Initial commit” 提交。 你可以在之后補(bǔ)上標(biāo)簽。 要在那個提交上打標(biāo)簽,你需要在命令的末尾指定提交的校驗(yàn)和(或部分校驗(yàn)和):
在這里插入圖片描述

可以看到你已經(jīng)在那次提交上打上標(biāo)簽了:
在這里插入圖片描述

4、共享標(biāo)簽

默認(rèn)情況下,git push 命令并不會傳送標(biāo)簽到遠(yuǎn)程倉庫服務(wù)器上。 在創(chuàng)建完標(biāo)簽后你必須顯式地推送標(biāo)簽到共享服務(wù)器上。 這個過程就像共享遠(yuǎn)程分支一樣——你可以運(yùn)行 git push origin <tagname>。

在這里插入圖片描述

如果想要一次性推送很多標(biāo)簽,也可以使用帶有 --tags 選項(xiàng)的 git push 命令。 這將會把所有不在遠(yuǎn)程倉庫服務(wù)器上的標(biāo)簽全部傳送到那里。
在這里插入圖片描述

現(xiàn)在,當(dāng)其他人從倉庫中克隆或拉取,他們也能得到你的那些標(biāo)簽。

git push 推送兩種標(biāo)簽:
使用 git push <remote> --tags 推送標(biāo)簽并不會區(qū)分輕量標(biāo)簽和附注標(biāo)簽,沒有簡單的選項(xiàng)能夠讓你只選擇推送一種標(biāo)簽。

5、刪除標(biāo)簽

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

在這里插入圖片描述

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

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

在這里插入圖片描述

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

第二種更直觀的刪除遠(yuǎn)程標(biāo)簽的方式是:

git push origin --delete <tagname>
在這里插入圖片描述

6、檢出標(biāo)簽

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

在這里插入圖片描述

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


在這里插入圖片描述

如果在這之后又進(jìn)行了一次提交,v4.0.0 分支就會因?yàn)檫@個改動向前移動, 此時它就會和 v1.4 標(biāo)簽稍微有些不同,這時就要當(dāng)心了。

在這里插入圖片描述
zan.gif
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容