git标签管理

备注：

本文参考于廖雪峰老师的博客Git教程。依照其博客进行学习和记录，感谢其无私分享，也欢迎各位查看原文。

知识点

• git tag <name>新建一个标签，默认表示的是HEAD，当前提交.
• git tag v0.9 commit_id在指定提交上创建标签
• git tag -a <tagname> -m "blablabla..."指定标签信息；
• git tag -s <tagname> -m "blablabla..."用PGP签名标签；
• 命令git tag查看标签列表。
• git show <name>显示标签信息
• 删除标签git tag -d <tagname>
• 将本地标签推送到远程git push origin <tagname>
• 一次性推送全部标签到远程git push origin --tags
• 删除远程标签git push origin :refs/tags/<tagname>

标签

• 标签类似版本库的一个快照。当发布一个版本时，通常先在版本库中打一个标签(tag)，用以唯一确定打标签时刻的版本。
• 通过获取某个标签的版本，就可以把当时的历史版本取出来
• Git的标签本质也是指向某个commit的指针，类似于分支，但是标签不能移动，分支可以移动。创建和删除标签都是瞬间完成
• Git标签方便标识。因为原本的commit是一串数字（6a5819e...），但是tag v1.2就很方便查找和标识

Git上打标签

• 切换到需要打标签的分支上：

$ git checkout master
切换到分支 'master'
您的分支与上游分支 'origin/master' 一致。

• 创建标签tag

$ git tag v1.0

• 查看标签tag历史

$ git tag
v1.0

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

如果忘了打标签，可以查找历史提交的commit_id，在指定commit_id上打标签

• 指定commit_id上打标签,如下，在提交merged fixed bug上打新标签

查看commit_id

$ git log --pretty=oneline --abbrev-commit
af1b0b3 add some word on master
faaaaa6 merged fixed bug
afc33ef fixed a bug
0df6e43 Merge branch 'dev'

在commit_id上打标签，查看tag历史

$ git tag v0.9 faaaaa6
$ git tag
v0.9
v1.0

• tag标签是按字母顺序排序的，使用git show <tagname>查看标签信息

$ git show v0.9
commit faaaaa6756a8d04c269b7b5ddccfc2a9e67108db
Merge: 0df6e43 afc33ef
Author: findmoon <[e-mail]>
Date:   Wed Feb 21 22:25:03 2018 +0800
    merged fixed bug

• 创建带有说明的标签，-a指定标签名，-m指定标签说明

$ git tag -a v0.8 -m"version 0.8 released" 7c4d427

• git show显示标签说明和信息

$ git show v0.8
tag v0.8
Tagger: findmoon <[e-mail]>
Date:   Thu Feb 22 10:39:40 2018 +0800

version 0.8 released

commit 7c4d4271b7bbd7a9898574ff3cfa795f40f9bbe3
Merge: 8f69de8 44dffc0
Author: findmoon <[e-mail]>
Date:   Wed Feb 21 14:54:46 2018 +0800

    merge with no-ff

• 使用-s参数，用私钥签名一个标签

$ git tag -s v0.7 -m"version 0.7 released" afc33ef
gpg: 钥匙环‘/home/liu/.gnupg/secring.gpg’已建立
gpg: 钥匙环‘/home/liu/.gnupg/pubring.gpg’已建立
gpg: “findmoon <[e-mail]>”已跳过：私钥不可用
gpg: signing failed: 私钥不可用
error: gpg 无法为数据签名
error: 无法签署标签

因为签名采用PGP签名，所以必须首先安装gpg(GnuPG)，没有gpg或者gpgp密钥对，就会报错。

用PGP签名的标签是不可伪造的

标签的管理

• 删除标签git tag -d <tagname>

$ git tag -d v0.8
已删除标签 'v0.8'（曾为 08825cf）

• 将本地标签推送到远程git push origin <tagname>

$ git push origin v1.0
Total 0 (delta 0), reused 0 (delta 0)
To [e-mail]:findmoon/newrepo.git
 * [new tag]         v1.0 -> v1.0

• 一次性推送全部为推送的标签到远程git push origin --tags

$ git push origin --tags
对象计数中: 1, 完成.
写入对象中: 100% (1/1), 164 bytes | 0 bytes/s, 完成.
Total 1 (delta 0), reused 0 (delta 0)
To [e-mail]:findmoon/newrepo.git
 * [new tag]         0.8 -> 0.8
 * [new tag]         v0.9 -> v0.9

• 标签推送到远程后的删除

1. 先删除本地标签

$ git tag -d 0.8
已删除标签 '0.8'（曾为 4dcd55c）

2. 删除远程标签git push origin :refs/tags/<tagname>

$ git push origin :refs/tags/0.8
To [e-mail]:findmoon/newrepo.git
 - [deleted]         0.8