@[TOC]
像其他版本控制系統(VCS
)一樣,Git
可以給倉庫歷史中的某一個提交打上標簽,以示重要。 比較有代表性的是人們會使用這個功能來標記發布結點( v1.0
、 v2.0
等等)。 在本節中,你將會學習如何列出已有的標簽、如何創建和刪除新的標簽、以及不同類型的標簽分別是什么。
1、列出標簽
在 Git
中列出已有的標簽非常簡單,只需要輸入 git tag
(可帶上可選的 -l
選項 --list
):
我這個倉庫還沒有推送過標簽,所以顯示為空。
這個命令以字母順序列出標簽,但是它們顯示的順序并不重要。
看一下git
源碼庫的標簽:
你也可以按照特定的模式查找標簽。 例如,
Git
自身的源代碼倉庫包含標簽的數量超過 500 個。 如果只對 1.8.5
系列感興趣,可以運行:
按照通配符列出標簽需要
-l
或 --list
選項:
如果你只想要完整的標簽列表,那么運行
git tag
就會默認假定你想要一個列表,它會直接給你列出來, 此時的-l
或--list
是可選的。然而,如果你提供了一個匹配標簽名的通配模式,那么
-l
或--list
就是強制使用的。
2、創建標簽
Git 支持兩種標簽:輕量標簽(lightweight
)與附注標簽(annotated
)。
輕量標簽很像一個不會改變的分支——它只是某個特定提交的引用。
而附注標簽是存儲在 Git
數據庫中的一個完整對象, 它們是可以被校驗的,其中包含打標簽者的名字、電子郵件地址、日期時間, 此外還有一個標簽信息,并且可以使用 GNU Privacy Guard (GPG)
簽名并驗證。 通常會建議創建附注標簽,這樣你可以擁有以上所有信息。但是如果你只是想用一個臨時的標簽, 或者因為某些原因不想要保存這些信息,那么也可以用輕量標簽。
2.1、附注標簽
在 Git
中創建附注標簽十分簡單。 最簡單的方式是當你在運行 tag
命令時指定 -a
選項:
-m
選項指定了一條將會存儲在標簽中的信息。 如果沒有為附注標簽指定一條信息,Git
會啟動編輯器要求你輸入信息。
通過使用 git show
命令可以看到標簽信息和與之對應的提交信息:
輸出顯示了打標簽者的信息、打標簽的日期時間、附注信息,然后顯示具體的提交信息。
2.2、輕量標簽
另一種給提交打標簽的方式是使用輕量標簽。 輕量標簽本質上是將提交校驗和存儲到一個文件中——沒有保存任何其他信息。 創建輕量標簽,不需要使用 -a
、-s
或 -m
選項,只需要提供標簽名字:
這時,如果在標簽上運行
git show
,你不會看到額外的標簽信息。 命令只會顯示出提交信息:
3、后期打標簽
你也可以對過去的提交打標簽。 假設提交歷史是這樣的:
現在,假設在
v1.0
時你忘記給項目打標簽,也就是在 “Initial commit
” 提交。 你可以在之后補上標簽。 要在那個提交上打標簽,你需要在命令的末尾指定提交的校驗和(或部分校驗和):可以看到你已經在那次提交上打上標簽了:
4、共享標簽
默認情況下,git push
命令并不會傳送標簽到遠程倉庫服務器上。 在創建完標簽后你必須顯式地推送標簽到共享服務器上。 這個過程就像共享遠程分支一樣——你可以運行 git push origin <tagname>
。
如果想要一次性推送很多標簽,也可以使用帶有
--tags
選項的 git push
命令。 這將會把所有不在遠程倉庫服務器上的標簽全部傳送到那里。現在,當其他人從倉庫中克隆或拉取,他們也能得到你的那些標簽。
git push
推送兩種標簽:
使用git push <remote> --tags
推送標簽并不會區分輕量標簽和附注標簽,沒有簡單的選項能夠讓你只選擇推送一種標簽。
5、刪除標簽
要刪除掉你本地倉庫上的標簽,可以使用命令 git tag -d <tagname>
。 例如,可以使用以下命令刪除一個輕量標簽:
注意上述命令并不會從任何遠程倉庫中移除這個標簽,你必須用
git push <remote> :refs/tags/<tagname>
來更新你的遠程倉庫:
第一種變體是 git push <remote> :refs/tags/<tagname>
:
上面這種操作的含義是,將冒號前面的空值推送到遠程標簽名,從而高效地刪除它。
第二種更直觀的刪除遠程標簽的方式是:
git push origin --delete <tagname>
6、檢出標簽
如果你想查看某個標簽所指向的文件版本,可以使用 git checkout
命令, 雖然這會使你的倉庫處于“分離頭指針(detached HEAD
)”的狀態——這個狀態有些不好的副作用:
在“分離頭指針”狀態下,如果你做了某些更改然后提交它們,標簽不會發生變化, 但你的新提交將不屬于任何分支,并且將無法訪問,除非通過確切的提交哈希才能訪問。 因此,如果你需要進行更改,比如你要修復舊版本中的錯誤,那么通常需要創建一個新分支:
如果在這之后又進行了一次提交,v4.0.0
分支就會因為這個改動向前移動, 此時它就會和 v1.4
標簽稍微有些不同,這時就要當心了。