Git基礎學習之標籤tag的使用詳解

2022-10-22 14:01:04

1、標籤介紹

軟體的某個發行版本所對應的，其實就是軟體開發過程中，某一個階段的最後一次git commit提交。我們知道每一個提交操作，對應的都會生成一個commit-id，而標籤就是與某一個commit-id繫結的名稱。一個標籤一旦與某一個commit-id繫結，那麼該標籤就不能修改繫結到其它commit-id了，除非將該標籤刪除後才可以與其commit-id繫結。

標籤物件（tag object） 非常類似於一個提交物件，它包含一個標籤建立者資訊、一個日期、一段註釋資訊，以及一個指標。主要的區別在於，標籤物件通常指向一個提交物件，而不是一個樹物件。它像是一個永不移動的分支參照，永遠指向同一個提交物件，只不過給這個提交物件加上一個更友好的名字罷了。

像其他版本控制系統（VCS）一樣，Git 可以給倉庫歷史中的某一個提交打上標籤，以示重要。比較有代表性的是，人們會使用這個功能來標記釋出結點（ v1.0 、 v2.0 等等），我們也可以稱標籤tag為里程碑。

2、列出標籤

在 Git 中列出已有的標籤非常簡單，只需要輸入 git tag （可帶上可選的 -l 選項 --list）：

$ git tag
v1.0
v2.0

這個命令以字母順序列出標籤，但是它們顯示的順序並不重要。

檢視具體標籤的詳情，使用命令：git show 標名稱。

你也可以按照特定的模式查詢標籤。例如，Git 自身的原始碼倉庫包含標籤的數量超過 500 個。如果只對1.8.5 系列感興趣，可以執行：

$ git tag -l "v1.8.5*"
v1.8.5
v1.8.5-rc0
v1.8.5-rc1
v1.8.5-rc2
v1.8.5.1
v1.8.5.2
v1.8.5.3

提示：

如果你只想檢視完整的標籤列表，執行 git tag 命令，會預設以列表的方式展現版本庫中的標籤。

如果你提供了一個匹配標籤名的通配模式，如上"v1.8.5*"，那麼 -l 或 --list 選項就是強制要使用的。

3、建立標籤

（1）標籤的分類

Git 支援兩種標籤：輕量標籤（lightweight）與附註標籤（annotated）。

輕量標籤：很像一個不會改變的分支，它只是某個特定提交的參照。

附註標籤：輕量標籤只有標籤名稱，而使用附註標籤，還可以為標籤新增說明。

是儲存在 Git 資料庫中的一個完整物件，它們是可以被校驗的，其中包含打標籤者的名字、電子郵件地址、日期時間，此外還有一個標籤資訊，並且可以使用GNU Privacy Guard （GPG）簽名並驗證。
提示：GPG是一種加密演演算法，現在Github支援提交使用GPG加密，從而保證提交的資料，在傳輸的過程中沒有被篡改。
通常會建議建立附註標籤，這樣你可以擁有以上所有資訊。
但是如果你只是想用一個臨時的標籤，或者因為某些原因不想要儲存這些資訊，那麼也可以用輕量標籤。
建立附註標籤，就會產生Git中的第四種物件：tag物件。

（2）附註標籤

在 Git 中建立附註標籤十分簡單。

執行命令：git tag -a 標籤名 -m '說明資訊'。

提示：這是在最新一次提交打上，打標籤。即若不指定標籤繫結的commit-id，則預設為HEAD指標所指向的提交。

-a選項意為"建立一個帶註解的標籤"。（a 即 annotated 的縮寫）

不用-a 選項也可以執行的，但該標籤不會記錄這標籤是什麼時候打的，誰打的，也不會讓你給該標籤新增註解。

我推薦一直建立帶註解的標籤。

$ git tag -a v1.4 -m "my version 1.4"
$ git tag
v1.3
v1.4

-m 選項指定該標籤的說明資訊（必須）。

如果你建立標籤的時候，沒有指定說明資訊，Git 會啟動編輯器要求你輸入資訊。

通過使用 git show 命令，可以看到標籤資訊和與之對應的提交資訊：

$ git show v1.4
tag v1.4
Tagger: Ben Straub <ben@straub.cc>	# 打標記的人
Date:   Sat May 3 20:19:12 2014 -0700	# 打標機的實際

my version 1.4	# 標記的說明資訊

# 以下是標記所對應的commit物件的資訊
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Mar 17 21:52:11 2008 -0700

    changed the version number

輸出顯示了打標籤者的資訊、打標籤的日期時間、標記說明資訊，然後顯示具體的提交資訊。

（3）輕量標籤

輕量標籤本質上是將提交校驗和儲存到一個檔案中，而沒有儲存任何其他資訊。

執行命令：git tag 標籤名。

建立輕量標籤，不需要使用 -a、-s（建立GPG簽名） 或 -m 選項，只需要提供標籤名字：

$ git tag v1.4-lw
$ git tag
v1.3
v1.4
v1.4-lw

這時，如果在標籤上執行 git show 命令，你不會看到額外的標籤資訊。

只會顯示出對應的提交資訊，如下：

$ git show v1.4-lw
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Mar 17 21:52:11 2008 -0700

    changed the version number

4、後期打標籤

你也可以對過去的某個提交打標籤。

版本庫提交歷史如下：

L@DESKTOP-T2AI2SU MINGW64 /j/git-repository/learngit (master)
$ git log --oneline --graph
*   3110083 (HEAD -> master) 第7次提交，完成dev分支的新功能
|
| * e94af28 第6次提交，修改dev和readme檔案
| * 9eb3224 第4次提交，dev分支開發 dev.txt檔案
* | 0690030 第5次提交，新增內容：branch test v4
|/
* b97ccfd 第3次提交，新增內容：branch test v3
* f72a9fe 第2次提交，新增內容：branch test v2
* fa2439a 第1次提交，新增readme.txt檔案

現在假設你在第3次提交的位置，忘記給專案打標籤，你可以在後邊的任何時間，在該位置補上標籤。

但是要注意，第3次提交的校驗和，要加入到命令之中。

執行命令：git tag -a 標籤名 commit-id -m '說明資訊'。

# 1.打標籤
L@DESKTOP-T2AI2SU MINGW64 /j/git-repository/learngit (master)
$ git tag -a v1.0 b97ccfd -m 'v1.0 里程碑'

# 2.版本庫提交歷史
L@DESKTOP-T2AI2SU MINGW64 /j/git-repository/learngit (master)
$ git log --oneline --graph
*   3110083 (HEAD -> master) 第7次提交，完成dev分支的新功能
|
| * e94af28 第6次提交，修改dev和readme檔案
| * 9eb3224 第4次提交，dev分支開發 dev.txt檔案
* | 0690030 第5次提交，新增內容：branch test v4
|/
* b97ccfd (tag: v1.0) 第3次提交，新增內容：branch test v3	# 看這行
* f72a9fe 第2次提交，新增內容：branch test v2
* fa2439a 第1次提交，新增readme.txt檔案

我們在版本庫的歷史提交資訊中，可以看到你已經在第3次提交上打上了標籤。

我們再來檢視一下，v1.0這個標籤的資訊。

$ git show v1.0
tag v1.0
Tagger: sun_wk <sun_wk@126.com>
Date:   Sun Apr 18 17:12:53 2021 +0800

v1.0 里程碑

commit b97ccfd5f3e98c12ab9c0fb4ca4b308e6805f7ed (tag: v1.0)
Author: sun_wk <sun_wk@126.com>
Date:   Fri Apr 16 22:07:47 2021 +0800

    第3次提交，新增內容：branch test v3

提示：輕量標籤執行命令：git tag 標籤名 commit-id。

到此這篇關於Git基礎學習之標籤tag的使用詳解的文章就介紹到這了,更多相關Git 標籤tag內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com！