簡述

作為版本管理工具，Git可以對某個版本打上標籤(tag)，表示本版本為發行版。在釋出軟體，以及使用CocoaPods建立依賴庫等情況時，需要對其版本使用標籤註釋。故簡單總結一下新增tag的方式。

使用Git命令

檢視標籤

列印所有標籤

git tag`

列印符合檢索條件的標籤

git tag -l <版本號>

如 git tag -l 1.*.* 為搜尋一級版本為1的版本

檢視對應標籤狀態

git checkout <版本號>

建立本地標籤

建立輕量標籤

輕量標籤指向一個發行版的分支，其只是一個像某commit的引用，不儲存名稱時間戳及標籤說明等資訊。定義方法如下

git tag <版本號>-light

建立帶附註標籤

相對於輕量標籤，附註標籤是一個獨立的標籤物件，包含了名稱時間戳以及標籤備註等資訊，同時指向對應的commit。定義方法如下

git tag -a <版本號> -m "<備註資訊>"

同時我們也可以像特定的commit新增標籤，使用該commit對應的SHA值即可

git tag -a <版本號> <SHA值> -m "<備註資訊>"

比如 git tag -a 1.0.0 0c3b62d -m "Release Edition v1.0.0" 就是為SHA為0c3b62d的這次提交打了1.0發行版的tag

刪除本地標籤

git tag -d <版本號>

將本地標籤提交到遠端倉庫

前面所提到的建立標籤，只是將標籤新增到了本地的版本管理，我們需要在建立之後將本地標籤同步到遠端倉庫，如Github。

推送所有標籤

git push origin --tags

推送指定版本的標籤

git push origin <版本號>

刪除遠端倉庫的標籤

同建立本地標籤一樣，刪除了本地標籤之後也要同時刪除遠端倉庫的標籤。

新版本Git (> v1.7.0)

git push origin --delete <版本號>
 

新舊版本通用方法

舊版本Git並沒有提供直接刪除的方法，而我們可以通過將一個空標籤替換現有標籤來實現刪除標籤，即如下命令

git push origin :refs/tags/<版本號>

補充：使用Github新增標籤

Github為我們提供了在頁面上進行編輯發行版本的方式，如下圖所示：

在Github上為專案打tag可在release頁面，選擇建立新tag並按下圖所示填寫即可。刪除tag也同理。母。

總結

最後總結一下常用命令，方便查閱。

/// 檢視標籤
// 列印所有標籤
git tag
// 列印符合檢索條件的標籤
git tag -l 1.*.*
// 檢視對應標籤狀態
git checkout 1.0.0

/// 建立標籤(本地)
// 建立輕量標籤
git tag 1.0.0-light
// 建立帶備註標籤(推薦)
git tag -a 1.0.0 -m "這是備註資訊"
// 針對特定commit版本SHA建立標籤
git tag -a 1.0.0 0c3b62d -m "這是備註資訊"

/// 刪除標籤(本地)
git tag -d 1.0.0

/// 將本地標籤釋出到遠端倉庫
// 傳送所有
git push origin --tags
// 指定版本傳送
git push origin 1.0.0

/// 刪除遠端倉庫對應標籤
// Git版本 > V1.7.0
git push origin --delete 1.0.0
// 舊版本Git
git push origin :refs/tags/1.0.0