[TOC] #### 1. 標(biāo)簽介紹 --- **應(yīng)用場景** 當(dāng)我們發(fā)布版本時，通常會先在版本庫打一個標(biāo)簽，這個標(biāo)簽就是我們平時所說代碼倉庫的版本號 標(biāo)簽是版本庫的一個快照，但它其實就是指向某個 commit 的指針。所以，創(chuàng)建和刪除標(biāo)簽都是瞬間完成的 **git 有 commit ，為什么還要引入 tag ?** “請把上周一的那個版本打包發(fā)布，commit號是 6a5819e...” “一串亂七八糟的數(shù)字不好找！” 如果換一個辦法： “請把上周一的那個版本打包發(fā)布，版本號是v1.2” “好的，按照tag v1.2查找commit就行！” 所以，tag 就是一個讓人容易記住的有意義的名字，它跟某個 commit 綁在一起。 #### 2. 查看標(biāo)簽 --- ``` # 查看本地庫標(biāo)簽 git tag # 一行顯示多個標(biāo)簽 git tag --column ``` #### 3. 創(chuàng)建標(biāo)簽 --- 創(chuàng)建標(biāo)簽 ``` # 基于當(dāng)前 commit id 創(chuàng)建標(biāo)簽 git tag <tagname> # 基于指定 commit id 創(chuàng)建標(biāo)簽 git tag <tagname> <commit id> ``` 創(chuàng)建標(biāo)簽并且添加標(biāo)簽描述（如果不帶 -m 參數(shù)會進入 vi 編輯模式輸入標(biāo)簽描述） ``` # `-a, --annotate` 標(biāo)簽名 `-m, --message` 標(biāo)簽描述 git tag -a <tagname> -m <message> # 經(jīng)測試，-a 不寫也是可以的 git tag <tagname> -m <message> ``` 使用示例 ``` # 添加標(biāo)簽 git tag v1.0.0 # 創(chuàng)建標(biāo)簽并設(shè)置標(biāo)簽描述 git tag v1.0.0 -m '正式上線' git tag -a v1.0.0 -m '正式上線' ``` 當(dāng)在代碼托管平臺中新增了標(biāo)簽，如果想要將遠程倉庫中新增的標(biāo)簽更新到本地，只需執(zhí)行 ``` git pull ``` #### 4. 刪除標(biāo)簽 --- 有時會因為手速過快導(dǎo)致標(biāo)簽名稱打錯了，此時可以刪除該標(biāo)簽，重新創(chuàng)建 因為創(chuàng)建的標(biāo)簽都只存儲在本地，不會自動推送到遠程庫。所以，打錯的標(biāo)簽可以在本地安全刪除 ``` # 刪除本地標(biāo)簽 git tag -d <tagname> # 刪除遠程倉庫中的標(biāo)簽的幾種方式 git push origin -d <tagname> git push origin :<tagname> git push origin :refs/tags/<tagname> # 使用示例 git tag -d v1.0.0 git push origin -d v1.0.0 git push origin :v1.0.0 git push origin :refs/tags/v1.0.0 ``` 要看看是否真的從遠程庫刪除了標(biāo)簽，可以登錄遠程倉庫查看，比如: Gitee、GitHub。也可以通過下面命令查看： ``` # 查看遠程庫標(biāo)簽 git ls-remote --tags ``` #### 5. 修改標(biāo)簽 --- git 并沒有直接修改標(biāo)簽名的命令，但是可以根據(jù)標(biāo)簽名創(chuàng)建新的標(biāo)簽，然后將舊的標(biāo)簽刪除 ``` # 根據(jù)指定標(biāo)簽創(chuàng)建新標(biāo)簽 git tag <new_tagname> <old_tagname> # 刪除本地倉庫中的舊標(biāo)簽 git tag -d <old_tagname> # 將新標(biāo)簽推送到遠程庫、將舊標(biāo)簽從遠程庫中刪除 git push <remote> <new_tagname> :<old_tagname> ``` 下面兩種寫法等同，建議使用第一種寫法: ``` # 寫法一: # 將新標(biāo)簽推送到遠程庫、將舊標(biāo)簽從遠程庫中刪除 git push <remote> <new_tagname> :<old_tagname> # 寫法二: # 將新標(biāo)簽推送遠程庫 git push <remote> <new_tagname> # 刪除遠程倉庫中的舊標(biāo)簽 git push <remote> :<old_tagname> ``` #### 6. 推送標(biāo)簽 --- 將本地標(biāo)簽推送到遠程倉庫 ``` # 將指定標(biāo)簽推送到遠程倉庫 git push <remote> <tagname> # 將所有本地標(biāo)簽一次性推送到遠程倉庫 git push <remote> --tags # 使用示例 git push origin v1.0.0 git push origin --tags ``` #### 7. 檢出標(biāo)簽 --- 可以通過標(biāo)簽名稱，檢出相應(yīng)版本的代碼 ``` git checkout <tagname> ``` 實際開發(fā)中，如果需要基于指定標(biāo)簽進行開發(fā)，可以先檢出標(biāo)簽，然后創(chuàng)建新的分支，在這個新分支上進行開發(fā) ``` # 切換到標(biāo)簽對應(yīng)的提交記錄 git checkout <tagname> # 創(chuàng)建并切換到新分支 git checkout -b <branch> ``` 基于指定標(biāo)簽創(chuàng)建分支也有更簡潔的寫法 ``` git checkout -b <branch> <tagname> ``` #### 8. git show 查看標(biāo)簽 --- 查看標(biāo)簽以及指向的對象。其實就是查看標(biāo)簽的備注和對應(yīng)的提交記錄 ``` git show v1.0.0 ``` 查看標(biāo)簽指向的樹。其實就是查看標(biāo)簽下的文件 ``` git show v1.0.0^{tree} ``` 查看標(biāo)簽對應(yīng)提交記錄的備注信息 ``` git show -s --format=%s v1.0.0^{commit} ```