侧边栏壁纸
博主头像
工作笔记

若批评无自由,则赞美无意义。

  • 累计撰写 190 篇文章
  • 累计创建 204 个标签
  • 累计收到 21 条评论
标签搜索

目 录CONTENT

文章目录

十、git 标签

工作笔记
2022-11-11 / 0 评论 / 0 点赞 / 274 阅读 / 2,198 字 / 正在检测是否收录...
温馨提示:
🌝 免责声明:本文存在此处完全是为了方便个人工作记录学习,不存在任何商业利益信息。若不小心影响到您的利益,请联系首页博主信息中公开的邮箱,博主将进行删除处理。谢谢合作!

git 标签

发布一个版本时,我们通常先在版本库中打一个标签(tag),这样,就唯一确定了打标签时刻的版本。将来无论什么时候,取某个标签的版本,就是把那个打标签的时刻的历史版本取出来。所以,标签也是版本库的一个快照。

Git 的标签虽然是版本库的快照,但其实它就是指向某个commit的指针(跟分支很像对不对?但是分支可以移动,标签不能移动),所以,创建和删除标签都是瞬间完成的。

Git 有commit,为什么还要引入tag

“请把上周一的那个版本打包发布,commit号是6a5819e…”

“一串乱七八糟的数字不好找!”

如果换一个办法:

“请把上周一的那个版本打包发布,版本号是v1.2”

“好的,按照tag v1.2查找commit就行!”

所以,tag就是一个让人容易记住的有意义的名字,它跟某个commit绑在一起。

在 Git 中创建标签非常简单,首先,切换到需要打标签的分支上:

$ git branch
* dev
  master
$ git checkout master
Switched to branch 'master'

git tag

然后,敲命令git tag <name>就可以打一个新标签:

$ git tag v1.0

可以用命令git tag查看所有标签:

$ git tag
v1.0

默认标签是打在最新提交的commit上的。有时候,如果忘了打标签,比如,现在已经是周五了,但应该在周一打的标签没有打,怎么办?

方法是找到历史提交的commit id,然后打上就可以了:

git log

$ git log --pretty=oneline --abbrev-commit
c7b409a (HEAD -> master) add merge
fb8b190 conflict fixed
06e5e3a & simple
2443c95 AND simple
4aac6c7 branch test
c47983c remove test.txt
9c18d80 add test.txt
f3c7825 git tracks changes
7a0050a understand how stage works
187f963 append GPL
e55063a add distributed
50ed06b wrote a readme file

比方说要对conflict fixed这次提交打标签,它对应的 commit id是fb8b190,敲入命令:

$ git tag v0.9 fb8b190

再用命令 git tag 查看标签:

$ git tag
v0.9
v1.0

注意,标签不是按时间顺序列出,而是按字母排序的。可以用git show 查看标签信息:

git show tagname

$ git show v0.9
commit fb8b190b016f5f19c7758ca21df0a5798a7a5fe1 (tag: v0.9)
Merge: 06e5e3a 2443c95
Author: Miykael_xxm <xiongjiamu@gmail.com>
Date:   Sun Nov 29 20:18:26 2020 +0800

    conflict fixed

(END)

可以看到,v0.9确实打在conflict fixed这次提交上。

还可以创建带有说明的标签,用-a指定标签名,-m指定说明文字:

$ git tag -a v0.1 -m "version 0.1 released" 187f963

用命令git show <tagname>可以看到说明文字:

git show tagname

$ git show v0.1
tag v0.1
Tagger: Miykael_xxm <xiongjiamu@gmail.com>
Date:   Sun Nov 29 22:06:05 2020 +0800

version 0.1 released

commit 187f963fa23f65050e1842f451046f4a66a94397 (tag: v0.1)
Author: Miykael_xxm <xiongjiamu@gmail.com>
Date:   Fri Nov 27 16:14:27 2020 +0800

    append GPL

diff --git a/readme.txt b/readme.txt
index 9247db6..8443d23 100644
--- a/readme.txt
+++ b/readme.txt
@@ -1,2 +1,2 @@
 Git is a distributed version control system.
-Git is free software.
+Git is free software distributed under the GPL.
(END)

注意:标签总是和某个commit挂钩。如果这个commit既出现在master分支,又出现在dev分支,那么在这两个分支上都可以看到这个标签。

以上就是 git 标签的基本内容,现在让我们来回顾一下:

  1. 命令 git tag <tagname> 用于新建一个标签,默认为HEAD,也可以指定一个commit id
  2. 命令 git tag -a <tagname> -m "message" 可以指定标签信息
  3. 命令 git tag 可以查看所有标签

接下来,让我们看看 git tag 都还有哪些其他操作吧。

如果标签打错了,也可以删除:

删除 tag

$ git tag -d v0.1
Deleted tag 'v0.1' (was 94e0f81)

因为创建的标签都只存储在本地,不会自动推送到远程。所以,打错的标签可以在本地安全删除。

如果要推送某个标签到远程,使用命令git push origin <tagname>

推送 tag

$ git push origin v1.0
Total 0 (delta 0), reused 0 (delta 0), pack-reused 0
To codechina.csdn.net:xiongjiamu/learning-git.git
 * [new tag]         v1.0 -> v1.0

或者,一次性推送全部尚未推送到远程的本地标签:

一次性推送本地 tag

$ git push origin --tags
Enumerating objects: 1, done.
Counting objects: 100% (1/1), done.
Writing objects: 100% (1/1), 171 bytes | 171.00 KiB/s, done.
Total 1 (delta 0), reused 0 (delta 0), pack-reused 0
To codechina.csdn.net:xiongjiamu/learning-git.git
 * [new tag]         remove -> remove
 * [new tag]         v0.1 -> v0.1
 * [new tag]         v0.9 -> v0.9

如果标签已经推送到远程,要删除远程标签就麻烦一点,先从本地删除:

删除已推送的 tag

$ git tag -d remove
Deleted tag 'remove' (was c47983c)

然后,从远程删除。删除命令也是push,但是格式如下:

$ git push origin :refs/tags/remove
To codechina.csdn.net:xiongjiamu/learning-git.git
 - [deleted]         remove

其实,在上面介绍到的标签都只是 git 标签中的一种,叫轻量级的标签(lightweight),轻量级标签就像是个不会变化的分支,实际上它就是个指向特定提交对象的引用。

另外一种 git 标签叫含附注的标签(annotated),附注标签实际上是存储在仓库中的一个独立对象,它有自身的校验和信息,包含着标签的名字,电子邮件地址和日期,以及标签说明,标签本身也允许使用 GNU Privacy Guard (GPG) 来签署或验证。一般我们都建议使用含附注型的标签,以便保留相关信息;当然,如果只是临时性加注标签,或者不需要旁注额外信息,用轻量级标签也没问题。

创建一个含附注类型的标签非常简单,用 -a (译注:取 annotated 的首字母)指定标签名字即可:

创建含附注类型的 tag

$ git tag -a v1.1 -m 'my version 1.1'
$ git tag
v0.1
v0.9
v1.0
v1.1

而 -m 选项则指定了对应的标签说明,Git 会将此说明一同保存在标签对象中。如果没有给出该选项,Git 会启动文本编辑软件供你输入标签说明。

可以使用 git show 命令查看相应标签的版本信息,并连同显示打标签时的提交对象。

git show tagname

$ git show v1.1
tag v1.1
Tagger: Miykael_xxm <xiongjiamu@gmail.com>
Date:   Tue Dec 22 14:29:54 2020 +0800

my version 1.1

commit 22a1da7ef25e09d9c4e7e5ec40a70e4543187067 (HEAD -> master, tag: v1.1, origin/master)
Author: Miykael_xxm <xiongjiamu@gmail.com>
Date:   Tue Dec 22 13:47:00 2020 +0800

    add author

diff --git a/hello.py b/hello.py
index 79e4c5b..d1f1616 100644
--- a/hello.py
+++ b/hello.py
@@ -1,3 +1,4 @@
 print('hello!');
 set exit=1;
 # add comment here~~~
+# author = xxm

如果你有自己的私钥,还可以用 GPG 来签署标签,只需要把之前的选项 -a 改为 -s (译注: 取 signed 的首字母)即可:

签署标签

$ git tag -s v1.2 -m 'my signed 1.2 tag'
You need a passphrase to unlock the secret key for
user: "Miykaelxxm <xiongjiamu@gmail.com>"

现在再运行 git show 会看到对应的 GPG 签名也附在其内:

git show tagname

$ git show v1.2
tag v1.2
Tagger: Miykael_xxm <xiongjiamu@gmail.com>
Date:   Tue Dec 22 18:06:23 2020 +0800

my signed 1.2 tag
-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEHOy0Yk8t45g6ChHzlteTkFPbAvoFAl/prh8ACgkQlteTkFPb
AvpPDRAAk1j6zhHCpGfDR9e+0mmm0UTd2DxkMrgNDfnOur4Lap6vRBDGo2IOHisq
PFOhvTWEEKVVyDqeNgKm7ABu8IJvHLEgG2jSlsTEB5CpNzgkeZh84bfH3eKUW/o2
H/Gtn4nR1f7r+BfVVHAnfXimt263RNTnIa3nePGItwM+cB5eV9WRsS2zIhEd/4Ab
qlMKvEBD15+s567RYVN3q89Greur2jA+xVf0uYRLLl1iOzmtMDh6fMUK/i76oFa+
OJpfDog+otmg4jUvahG3hWUZBaZ6dDQ447SKT3siuoF+lZNPE4TSSKDyhe+BVD1o
19Xjn3+gYVvSlb/lPJ2i3x/tZbWX0wntFCb+CKlguryDg7lcDvl0L9cWMHKNTzGP
E1SGc2DMx4asXN6EbceEVZABAk79IWz73+1XU3CWHKhBrjWeWUDsshljO3oGI4Zt
ZvGVkATEvzZN+LC+AOxTDsL8KzeSncb38hWcB6IyRG8hLEVu3EjnvmZfMkwdRFad
n+xHzvNuiPAcAOLYhOUTWsdp2rmr5ZLkX4V+XFPZbLvAwoy+ngU/FVsaT2nWNZWf
JF6t6ZbMeKp+hzh+aZoUhh6ZTKazmPYg5b2AxIRhWEowXrKCYvWCWrv1NYp0M4xz
D0IJmmuL5L+noDi7U8crrnan/Sn8hD2veeYaFlypchZR2OKsPC8=
=fbHC
-----END PGP SIGNATURE-----

commit b6b8fb1fe3f11c1120840dc9237b7453fa882a62 (HEAD -> master, tag: v1.2, origin/master)
Author: Miykael_xxm <xiongjiamu@gmail.com>
Date:   Tue Dec 22 14:35:20 2020 +0800

    signed tag

diff --git a/LICENSE b/LICENSE
index 213a814..30c750f 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1 +1,2 @@
 This is a LICENSE file.
+With a signed tag.
(END)

以上就是 git tag操作的内容介绍了,现在让我们来回顾一下:

  1. 命令git push origin <tagname>可以推送一个本地标签;
  2. 命令git push origin --tags可以推送全部未推送过的本地标签;
  3. 命令git tag -d <tagname>可以删除一个本地标签;
  4. 命令git push origin :refs/tags/<tagname>可以删除一个远程标签
  5. 命令git tag -a <tagname> -m 'messages'可以创建一个带附注的标签
  6. 命令git tag -s <tagname> -m 'messages'可以创建一个带 gpg 签名的标签

到目前,本门关于 git 的课程内容已经全部都结束了。

0

评论区