Git 基礎 - 打標籤
打標籤
像其他版本控制系統（VCS）一樣，Git 可以給倉庫歷史中的某一個提交打上標籤，以示重要。 比較有代表性的是人們會使用這個功能來標記釋出結點（ v1.0 、 v2.0 等等）。 在本節中，你將會學習如何列出已有的標籤、如何建立和刪除新的標籤、以及不同型別的標籤分別是什麼。
列出標籤
在 Git 中列出已有的標籤非常簡單，只需要輸入 git tag （可帶上可選的 -l 選項 --list）：
$ git tag
v1.0
v2.0
這個命令以字母順序列出標籤，但是它們顯示的順序並不重要。
建立標籤
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 [email protected] Date: Sat May 3 20:19:12 2014 -0700
my version 1.4
commit ca82a6dff817ec66f44342007202690a93763949 Author: Scott Chacon [email protected] Date: Mon Mar 17 21:52:11 2008 -0700
changed the version number
```
輸出顯示了打標籤者的資訊、打標籤的日期時間、附註資訊，然後顯示具體的提交資訊。
輕量標籤
另一種給提交打標籤的方式是使用輕量標籤。 輕量標籤本質上是將提交校驗和儲存到一個檔案中——沒有儲存任何其他資訊。 建立輕量標籤，不需要使用 -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 [email protected] 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 [email protected] Date: Mon Feb 9 15:32:16 2009 -0800
version 1.2 commit 9fceb02d0ae598e95dc970b74767f19372d61af8 Author: Magnus Chacon [email protected] Date: Sun Apr 27 20:43:35 2008 -0700
updated rakefile
... ```
共享標籤
預設情況下，git push 命令並不會傳送標籤到遠端倉庫伺服器上。 在建立完標籤後你必須顯式地推送標籤到共享伺服器上。 這個過程就像共享遠端分支一樣——你可以執行 git push origin <tagname>。
$ 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 [email protected]: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 [email protected]:schacon/simplegit.git
* [new tag] v1.4 -> v1.4
* [new tag] v1.4-lw -> v1.4-lw
現在，當其他人從倉庫中克隆或拉取，他們也能得到你的那些標籤。
| Note | 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 /[email protected]: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
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 標籤稍微有些不同，這時就要當心了。