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

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 <[email protected]>	# 打標記的人
Date:   Sat May 3 20:19:12 2014 -0700	# 打標機的實際

my version 1.4	# 標記的說明信息

# 以下是標記所對應的commit對象的信息
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <[email protected]>
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 <[email protected]>
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 <[email protected]>
Date:   Sun Apr 18 17:12:53 2021 +0800

v1.0 裡程碑

commit b97ccfd5f3e98c12ab9c0fb4ca4b308e6805f7ed (tag: v1.0)
Author: sun_wk <[email protected]>
Date:   Fri Apr 16 22:07:47 2021 +0800

    第3次提交,新增內容:branch test v3

提示:輕量標簽執行命令:git tag 標簽名 commit-id

到此這篇關於Git基礎學習之標簽tag的使用詳解的文章就介紹到這瞭,更多相關Git 標簽tag內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!

推薦閱讀: