git标签——附带详细步骤

繁星蓝雨

已于 2024-04-03 20:33:36 修改

阅读量2k

点赞数

分类专栏： git 文章标签： git macos

于 2022-01-14 22:00:00 首次发布

原文链接：https://gitcode.net/qq_33375598/git-learning-course

版权

git 专栏收录该内容

6 篇文章

订阅专栏

文章目录

0 总结
1 轻量级的标签中（lightweight）
2 含附注的标签(annotated)
- 2.1 创建一个含附注类型的标签

0 总结

本文内容摘自gitCode的git教程。

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

1 轻量级的标签中（lightweight）

轻量级标签就像是个不会变化的分支，实际上它就是个指向特定提交对象的引用。

1.1 默认标签

默认标签是打在最新提交的commit上的。

打默认标签

$ git tag v1.0

1.2 指定标签

$ git log --pretty=oneline --abbrev-commit

3d97ae0 (HEAD -> master, tag: v1.0, origin/master, origin/HEAD) 提交text.py
082cad1 Merge branch 'master' of https://gitcode.net/qq_33375598/git-learning-course
0113c18 修改冲突
d56e63b Merge branch 'feature1' into 'master'
31b4c13 (origin/feature1) Creating a new branch is quick and simple.
7f34e0e & simple
13dcd3e (feature1) ADD A SAMPLE
9024f59 ADD A SAMPLE
f2f9a97 Update README.md
5d7e8d4 Initial commit

$ git tag v0.9 13dcd3e

1.3 查看标签

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

(base) mac@macbook git-learning-course % git show v0.9
commit 13dcd3e90e3a604c93ffea800e9731904ed3498a (tag: v0.9, feature1)
Author: 江雪 <jiangxue@local.lan>
Date:   Fri Jan 14 09:42:57 2022 +0800

    ADD A SAMPLE

diff --git a/README.txt b/README.txt
index 4411722..d768675 100644
--- a/README.txt
+++ b/README.txt
@@ -1 +1,2 @@
-Creating a new branch is quick.
\ No newline at end of file
+Creating a new branch feature1!
+Creating a new branch is quick AND simple.

1.4 创建标签文字说明(本地)

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

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

用命令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)

1.5 标签同步到远程

推送固定版本：

$ 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

1.6 删除标签(本地/远程)

本地：

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

远程：

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

2 含附注的标签(annotated)

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

2.1 创建一个含附注类型的标签

$ 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 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 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)