Git 与标签管理

在 Git 中,标签 tag 是指向某个 commit 的指针(所以创建和删除都很快)。Git 有 commit id 了,为什么还要有 tag?commit id 是一串无规律的数字,不好记;而 tag 是我们自定义的,例如我们可以命名为 v1.2

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

创建标签

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

bash 复制代码
$ git checkout master

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

bash 复制代码
$ git tag v1.0

默认标签是打在最新提交的 commit 上的。如果想要打在某个 commit id 上,指定 commit id 即可:

bash 复制代码
$ git tag v0.9 1794212

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

bash 复制代码
$ git tag
v0.9
v1.0

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

bash 复制代码
$ git show v0.9
commit 17942124f48557a93541974769ba1187321b8133 (tag: v0.9, bug)
Author: peterjxl <peterjxl@qq.com>
Date:   Sat Jan 14 20:06:01 2023 +0800

    fix bug

diff --git a/3-branch/branch.txt b/3-branch/branch.txt
index b7edfda..42c8f36 100644
--- a/3-branch/branch.txt
+++ b/3-branch/branch.txt
@@ -1,3 +1,3 @@
 Creating a new branch is quick and simple
 test no fast forward
-test
+test cherry-pick

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

bash 复制代码
$ git tag -a v0.1 -m "version 0.1 released" 1094adb

再次用 git show <tagname>​,可以看到说明文字:

bash 复制代码
$ git show v0.1
tag v0.1
Tagger: peterjxl <peterjxl@qq.com>
Date:   Sat Jan 14 20:50:31 2023 +0800

version 0.1 released

commit abf2051bd989d0b129066bff3700a019665469ce (tag: v0.1)
Author: peterjxl <peterjxl@qq.com>
Date:   Wed Jan 11 22:50:39 2023 +0800

    add diff and patch hello.txt

diff --git a/1-diffAndPath/hello.txt b/1-diffAndPath/hello.txt
new file mode 100644
index 0000000..9bef518
--- /dev/null
+++ b/1-diffAndPath/hello.txt
@@ -0,0 +1,2 @@
+This is hello file
+Welcome to diff

之前说的第一种是轻量标签(lightweight),第二种带说明的就是附注标签(annotated)。

轻量标签很像一个不会改变的分支------它只是某个特定提交的引用。

而附注标签是存储在 Git 数据库中的一个完整对象, 它们是可以被校验的,其中包含打标签者的名字、电子邮件地址、日期时间, 此外还有一个标签信息,并且可以使用 GNU Privacy Guard (GPG)签名并验证。 通常会建议创建附注标签,这样你可以拥有以上所有信息。但是如果你只是想用一个临时的标签, 或者因为某些原因不想要保存这些信息,那么也可以用轻量标签。

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

删除标签

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

bash 复制代码
$ git tag -d v0.1
Deleted tag 'v0.1' (was 361b94d)

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

推送标签

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

bash 复制代码
$ git push gitee v1.0
Total 0 (delta 0), reused 0 (delta 0), pack-reused 0
remote: Powered by GITEE.COM [GNK-6.4]
To gitee.com:peterjxl/LearnGit.git
 * [new tag]         v1.0 -> v1.0

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

bash 复制代码
$ git push gitee --tags
Total 0 (delta 0), reused 0 (delta 0), pack-reused 0
remote: Powered by GITEE.COM [GNK-6.4]
To gitee.com:peterjxl/LearnGit.git
 * [new tag]         v0.9 -> v0.9

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

bash 复制代码
$ git tag -d v0.9

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

bash 复制代码
$ git push origin :refs/tags/v0.9

第二种更直观的删除远程标签的方式是:

bash 复制代码
$ git push origin --delete <tagname>

要看看是否真的从远程库删除了标签,可以登录远程仓库查看。

查找标签

你也可以按照特定的模式查找标签。 例如,Git 自身的源代码仓库包含标签的数量超过 500 个。 如果只对 1.8.5 系列感兴趣,可以运行:

bash 复制代码
$ git tag -l "v1.8.5*"
v1.8.5
v1.8.5-rc0
v1.8.5-rc1
v1.8.5-rc2
v1.8.5-rc3
v1.8.5.1
v1.8.5.2
v1.8.5.3
v1.8.5.4
v1.8.5.5

小结

常用的 git tag 命令如下:

  • git tag tagName 创建标签
  • git tag 创建标签
  • 命令 git push origin <tagname> 可以推送一个本地标签;
  • 命令 git push origin --tags 可以推送全部未推送过的本地标签;
  • 命令 git tag -d <tagname> 可以删除一个本地标签;
  • 命令 git push origin :refs/tags/<tagname> 可以删除一个远程标签。

相关推荐
呆萌的代Ma3 小时前
Git不强行推送,撤销最近几次的提交
git
透明的玻璃杯6 小时前
git应用
git
炸炸鱼.7 小时前
Git+Jenkins实战(一):从零搭建自动化发布与回滚系统(附完整代码)
git·jenkins
言6669 小时前
要忽略前端依赖包node_modules的文件在目录下 git暂存区消失
git
胡小禾10 小时前
Git Worktree
git
程序员小羊!11 小时前
18 GIt
git
怣疯knight11 小时前
Git 本地分支关联远程分支 常用命令汇总
git
ANNENBERG11 小时前
git分支开发管理
git
坤坤藤椒牛肉面11 小时前
GIT的使用
git
w32963627111 小时前
使用 OpenCode 在 Windows 上加速安装 Playwright 的完整指南
windows·git