軟體的某個發行版本所對應的,其實就是軟體開發過程中,某一個階段的最後一次git commit
提交。我們知道每一個提交操作,對應的都會生成一個commit-id
,而標籤就是與某一個commit-id
繫結的名稱。一個標籤一旦與某一個commit-id
繫結,那麼該標籤就不能修改繫結到其它commit-id
了,除非將該標籤刪除後才可以與其commit-id
繫結。
標籤物件(tag object) 非常類似於一個提交物件,它包含一個標籤建立者資訊、一個日期、一段註釋資訊,以及一個指標。 主要的區別在於,標籤物件通常指向一個提交物件,而不是一個樹物件。 它像是一個永不移動的分支參照,永遠指向同一個提交物件,只不過給這個提交物件加上一個更友好的名字罷了。
像其他版本控制系統(VCS)一樣,Git 可以給倉庫歷史中的某一個提交打上標籤,以示重要。 比較有代表性的是,人們會使用這個功能來標記釋出結點( v1.0
、 v2.0
等等),我們也可以稱標籤tag
為里程碑。
在 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
選項就是強制要使用的。
Git 支援兩種標籤:輕量標籤(lightweight
)與附註標籤(annotated
)。
輕量標籤:很像一個不會改變的分支,它只是某個特定提交的參照。
附註標籤:輕量標籤只有標籤名稱,而使用附註標籤,還可以為標籤新增說明。
GNU Privacy Guard
(GPG
)簽名並驗證。GPG
是一種加密演演算法,現在Github支援提交使用GPG
加密,從而保證提交的資料,在傳輸的過程中沒有被篡改。tag
物件。在 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
輸出顯示了打標籤者的資訊、打標籤的日期時間、標記說明資訊,然後顯示具體的提交資訊。
輕量標籤本質上是將提交校驗和儲存到一個檔案中,而沒有儲存任何其他資訊。
執行命令: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
你也可以對過去的某個提交打標籤。
版本庫提交歷史如下:
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
。