说明

tag(标签) 是 git 版本库的指向某个 commit 的指针。主要用于在代码版本管理时，保存一个阶段性的版本。

tag 对应某次 commit, 是一个点，是不可移动的。branch 对应一系列 commit，是很多点连成的一根线，有一个HEAD 指针，是可以依靠 HEAD 指针移动的。所以，两者的区别决定了使用方式，改动代码用 branch ,不改动只查看用 tag。

tag 和 branch 的相互配合使用，有时候起到非常方便的效果，例如：已经发布了 v1.0 v2.0 v3.0 三个版本，这个时候，我突然想不改现有代码的前提下，在 v2.0 的基础上加个新功能，作为 v4.0 发布。就可以检出 v2.0 的代码作为一个 branch ，然后作为开发分支。

每创建一个 tag 会在 .git/refs/tags 目录下生成一个同名文件，该文件保存了 tag 对应的 commit 号。

tag 分为简易版本和修饰版本两种。简易版本在打 tag 时除了 commit 号不添加任何 message，主要用于个人或临时的版本。修饰版本（打tag 时使用了 -a/-s/-u 参数）还会包含创建时间，tag 名称和 email 等信息，主要用于正式发布的版本。

常用操作集

列出标签

git tag

搜索标签

# git tag -l ["tagename"]
git tag -l "v1.*"

查看标签

# git show [tagname]
git show v1.0.0

打一个新标签

# git tag [tagname] [commit]
git tag v1.0.0

v1.0.0 表示新的标签名称，如果不加 commit，默认在最后一个 commit 的基础上添加 tag。

切换到 tag 版本

# git checkout [tagname]
git checkout v1.0.0

此时会切换到打这个标签时的代码

删除标签

# git tag -d [tagname]
git tag -d v1.0.0

远程操作

# 推送标签到远程
git push origin [tagname]# 推送所有tag
git push [origin] --tags# 删除远程标签
git push origin :refs/tags/tagname

git tag 命令详解

使用格式

git tag [-a | -s | -u <keyid>] [-f] [-m <msg> | -F <file>] [-e]<tagname> [<commit> | <object>]
git tag -d <tagname>…
git tag [-n[<num>]] -l [--contains <commit>] [--no-contains <commit>][--points-at <object>] [--column[=<options>] | --no-column][--create-reflog] [--sort=<key>] [--format=<format>][--[no-]merged [<commit>]] [<pattern>…]
git tag -v [--format=<format>] <tagname>…

参数解释

-a / --annotate ：创建一个未签名的、带注释的标签对象。如果没有 -m 则会弹出输入框来填写标签信息。
-s / --sign : 使用默认电子邮件地址的密钥制作 GPG 签名标签。
--no_sign : 强制覆盖签名的 tag.gpgSign 配置变量，即不使用签名
-u <keyid> / --local-user=<keyid> : 使用给定的 keyid 生成签名标签
-f / --force ：如果标签名称已存在，则替换该标签。（通常情况下，标签存在时会报错）
-m <msg> : 使用给定的 msg 作为标签信息，使用此参数时，不会再出现 nano 弹窗来输入信息
-F <file> / --file=<file> : 从 file 文件中获取标签信息
-e / --edit : 从带有-F 的文件和带有-m 的命令行获取的消息通常用作未修改的标记消息。然后显示编辑窗口来进行修改。
-d / --delete : 删除标签
-n <num> : 在使用 -l 时，显示 num 行注释。不带此参数时，默认不打印注释，带了 -n 没有 num，则显示一行注释
-l / --list : 显示所有标签
--contains [<commit>] : 仅列出包含指定 commit 版本的标签
--no-contains [<commit>] : 除指定 commit 版本外，列出所有标签
--points-at <object> ：仅列出给定对象的标签
--column[=<options>] / --no-column : 按列/不案列显示标签
--create-reflog : 为标签创建一个 reflog。
--sort=<key> : 根据给定的关键字(key)进行排序，此参数可以多次使用
--format=<format> : 从显示的标记 ref 和它指向的对象中插入 %(fieldname) 的字符串。格式与 git-for-each-ref(1) 相同。未指定时，默认为 %(refname:strip=2)。
--merged [<commit>] : 仅列出指定 commit 版本对应的标签，不带 commit 时默认为 HEAD
--no-merged [<commit>] : 列出除指定 commit 版本之外所有的标签
-v / --verify : 验证标签的 GPG 签名
--cleanup=<mode> : 此选项设置如何清理标记消息。 <mode> 可以是verbatim、whitespace 和 strip 之一。strip 模式是默认的。verbatim 模式不会更改消息，whitespace 仅删除前导/尾随空格行，而剥离删除空格和注释。
<object> : 新标签将引用的对象，通常时 commit 号，默认为 HEAD。

什么是 git 签名标签

由于 Git 是分布式版本控制系统，所有的用户终端都可以创建标签和发布版本，当我们需要验证发行版的来源时，就可以使用签名标签。只有当标签的 GPG 密钥匹配时，才能验证该标签的真实创建这。

要创建签名标签首先需要设置 GPG 签名密钥:

git config --global user.signingkey [gpg-key-id]

如果有多个账户，则需要多个签名密钥，此时需要针对每个账户设置密钥。

然后创建一个标签并对其进行签名：

git tag --sign [signed-tag-name]

如果在创建签名标签时报错，说明还没有创建密钥对。

$ git tag --sign tag_sign
error: gpg failed to sign the data
error: unable to sign the tag

此时我们就需要创建密钥对，如果不确定，可以先检查 GPG 密钥对：

$ gpg --list-keys

没有的话，可以根据以下命令生成密钥：

$ gpg --gen-key

生成时可以根据 name 或者 email 产生，这个由个人选择。生成时间会很长，请耐心等待。

接下来就是验证我们创建的标签了，如果只是在本地验证标签，很简单：

git tag --verify [signed-tag-name]

但是通常我们的版本是要发布给别人使用的，那么对方就需要使用签名者的公钥才能验证版本。多数维护者将他们的公钥放在存储库中的一个特殊对象中——一个只能从特定标签（或者当然是它自己的 SHA）访问的对象。

我们可以按以下步骤在标签中添加公共密钥：

$ gpg -a --export [gpg-key-id] | git hash-object -w --stdin[object SHA]$ git tag -a [object SHA] maintainer-pgp-pub

要将维护者的公钥导入密钥环，可以显示标签：

$ git show maintainer-pgp-pub | gpg --import

参考资料

Git - git-tag Documentation

Signing Git tags

git tag 操作相关推荐

Git步步进阶---Git tag操作全解析
为什么要写这篇Git tag文章呢? 虽然已经使用Git很长时间,并且自认为对Git的操作也到了掌握的相当好的程度,但是当服务端部分的开发转向Go时,突然需要进行Git tag操作的地方多了起来,因为 ...
Git步步进阶---完美实战git tag所有操作
编者言:使用git tag是开发者的一项基本技能,他本质上是一个有标记的压缩包,当你的代码完成某些功能并上线没有问题的时候,这时你就需要打下一个tag(即将当前的代码保存起来并做上标记),这意义重大: ...
git切换远程分支和tag操作
Clone代码到本地执行git clone从远程仓库clone代码到本地仓库: git clone git@github.com:secbr/nacos.git 查看分支列表执行git branc ...
45 个 Git 经典操作场景，专治不会合代码
git对于大家应该都不太陌生,熟练使用git已经成为程序员的一项基本技能,尽管在工作中有诸如 Sourcetree这样牛X的客户端工具,使得合并代码变的很方便.但找工作面试和一些需彰显个人实力的场景, ...
[转]Git远程操作详解
原文:http://www.ruanyifeng.com/blog/2014/06/git_remote.html Git是目前最流行的版本管理系统,学会Git几乎成了开发者的必备技能. Git有很多 ...
git 常用操作总结
git diff branch1 branch2 # 显示出所有有差异的文件的详细差异 git diff branch1 branch2 --stat ...
Git tag 打标签
Git tag 给当前分支打标签给指定的commit打Tag 打Tag不必要在head之上,也可在之前的版本上打,这需要你知道某个提交对象的校验和(通过git log获取). 补打Tag $ git ...
Git 远程操作详解
2019独角兽企业重金招聘Python工程师标准>>> Git是目前最流行的版本管理系统,学会Git几乎成了开发者的必备技能. Git有很多优势,其中之一就是远程操作非常简便.本文详 ...
【Git】Git 标签使用 ( 查询哈希码 | 创建标签 git tag v1.0 | 查询标签 git tag | 查询标签信息 git show v1.0 | 创建标签并指定说明 | 删除标签 )
文章目录一.查询提交记录哈希码 1.git log --pretty=oneline --abbrev-commit 2.git reflog 二.为某个提交设置标签 git tag v1.0 23 ...

git tag 操作

说明