Git （10）-- 打標籤（git tag）
@
目錄像其他版本控制系統（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 標籤稍微有些不同，這時就要當心了。