[Git 文章收集] 版本控制: 如何使用標籤(Tag)

 Source From Here

Preface
Git Tag 功能就如同 Cvs Tag 是一樣的，您可以在專案裡面隨意新增 Tag，方便您紀錄訊息，底下一些基本的操作來學習如何使用標籤 (Tag) 功能 (新增標籤、以及各種不同類型標籤之間的差別)。

列出既有標籤
直接使用 git tag 即可:

$ git tag -l
v0.1
v1.3

如果整個專案過多 Tag 也可以透過底下方式搜尋出來

$ git tag -l 'v1.4.2.*'
v1.4.2.1
v1.4.2.2
v1.4.2.3
v1.4.2.4

新增標籤
-a 就是標籤名稱，-m 代表該標籤說明

$ git tag -a v1.4 -m 'my version 1.4'
$ git tag
v0.1
v1.3
v1.4

可以使用 git show 來顯示該標簽說明以及同時 commit 的資料:

$ git show -q
commit c9b5c43a953a2e9043cf66e5e460b01de2ac068d (HEAD -> master, tag: 'v0.1', origin/master)
Author: johnklee <puremonkey2001@yahoo.com.tw>
Date: Sat Aug 22 11:47:31 2020 +0800

update notebook of lesson "Predicting Credit Card Fraud"

也可以針對很久以前 Commit 的資料進行標籤:

$ git log --pretty=oneline
a30c79cf2ebaf5a66ea79852ac195bc828552a2d update README and edit logs/index.htm
77b54912cf6a21c96715b22c74694effed1b1f56 fixed: plurk cookie error
8ddb59176633e9e161835dcceaf453ee4f203bc3 update /API/Users/getKarmaStats
c7dffde325d8ab543f92286bb98c7263e52d6711 transfer tab to space
aa5a300028c3c34be034fc44c1a6caeeb43852e7 transfer tab to space
7c5f24d99e319d4300d3eade533f65ecbe1976dc update to 1.6.1
...

$ git tag -a v1.2 7c5f24d

上傳標籤到遠端
git push 並不會把標籤上傳到遠端，所以必須透過底下命令才行:

$ git push origin v1.5
Counting objects: 50, done.
Compressing objects: 100% (38/38), done.
Writing objects: 100% (44/44), 4.56 KiB, done.
Total 44 (delta 18), reused 8 (delta 1)
To git@github.com:schacon/simplegit.git
* [new tag] v1.5 -> v1.5

如果在本機端很多標籤，利用 –tags 一次上傳上去:

$ git push origin --tags
Counting objects: 50, done.
Compressing objects: 100% (38/38), done.
Writing objects: 100% (44/44), 4.56 KiB, done.
Total 44 (delta 18), reused 8 (delta 1)
To git@github.com:schacon/simplegit.git
* [new tag] v0.1 -> v0.1
* [new tag] v1.2 -> v1.2
* [new tag] v1.4 -> v1.4
* [new tag] v1.4-lw -> v1.4-lw
* [new tag] v1.5 -> v1.5

遠端刪除 Tag from remote Git repositories
只需要一行指令就可以了:

$ git push origin :refs/tags/my_tag

如果是還沒有送到 remote Git repositories 上的，可以使用 git 指令刪除:

$ git tag -d tag1( tag2 tag3...)

標籤其他功能
針對第 v2.5 跟其他 commits 名稱做比對

$ git diff v2.5 1b2e1d63ff

比較現在與 v2.5:

$ git diff v2.5 HEAD

開一個以 v.25 當作基底的 branch:

$ git branch stable v2.5

搜尋 v.25 裡面是否有 hello 字串:

$ git grep "hello" v2.5

觀看 v2.5 版本的 Makefile:

$ git show v2.5:Makefile

Supplement
* 2.6 Git Basics - Tagging
* Practical guide for git users - Git 上標籤(Tagging)