1. 显示标签
在Git
中列出已有的标签是非常简单直观的。只需要输入git tag
:
$ git tagv0.1v1.3
2. 创建标签
Git
使用两种主要类型的标签:轻量标签(lightweight
)与附注标签(annotated
)。
轻量标签很像一个不会改变的分支 - 它只是一个特定提交的引用;附注标签是存储在Git
数据库中的一个完整对象。它们是可以被校验的;其中包含打标签者的名字、电子邮件地址、日期时间;还有一个标签信息;
通常建议创建附注标签。
2.1 轻量标签
轻量标签本质上是将提交校验和存储到一个文件中 - 没有保存任何其他信息。命令git tag <name>
就可以打一个新标签:
$ git tag v1.4-lw$ git tagv0.1v1.3v1.4v1.4-lwv1.5
如果在标签上运行git show
,你不会看到额外的标签信息。命令只会显示出提交信息:
$ git show v1.4-lwcommit ca82a6dff817ec66f4434202690a93763949Author: Scott Chacon <schacon@gee->Date: Mon Mar 17 21:52:11 -0700changed the version number
2.2 附注标签
在Git
中创建一个附注标签是很简单的。用-a
指定标签名,-m
指定说明文字
$ git tag -a v1.4 -m 'my version 1.4' 1985ccf$ git tagv0.1v1.3v1.4
-m
选项指定了一条将会存储在标签中的信息。如果没有为附注标签指定一条信息,Git
会运行编辑器要求你输入信息。
通过使用git show
命令可以看到标签信息与对应的提交信息:
$ git show v1.4tag v1.4Tagger: Ben Straub <ben@>Date: Sat May 3 20:19:12 -0700my version 1.4commit ca82a6dff817ec66f4434202690a93763949Author: Scott Chacon <schacon@gee->Date: Mon Mar 17 21:52:11 -0700changed the version number
输出显示了打标签者的信息、打标签的日期时间、附注信息,然后显示具体的提交信息。
注意:标签总是和某个
commit
挂钩。如果这个commit
既出现在master
分支,又出现在dev
分支,那么在这两个分支上都可以看到这个标签。
3. 后期打标签
也可以对过去的提交打标签。假设提交历史是这样的:
$ git log --pretty=oneline15027957951b64cf874c3557a0f3547bd83b3ff6 Merge branch 'experiment'a6b4c97498bd301d84096da251c98a07c7723e65 beginning write support0d52aaab4479697da7686c15f77a3d64d9165190 one more thing6d52a271eda8725415634dd79daabbc4d9b6008e Merge branch 'experiment'0b7434d86859cc7b8c3d5e1dddfed66ff742fcbc added a commit function4682c3261057305bdd616e23b64b0857d832627b added a todo file166ae0c4d3f420721acbb115cc33848dfcc2121a started write support9fceb02d0ae598e95dc970b74767f19372d61af8 updated rakefile964f16d36dfccde844893cac5b347e7b3d44abbc commit the todo8a5cbc430f1a9c3d00faaeffd07798508422908a updated readme
或者通过命令查看历史提交
git log --pretty=oneline --abbrev-commit
现在,假设在v1.2
时你忘记给项目打标签,也就是在 “updated rakefile” 提交。你可以在之后补上标签。要在那个提交上打标签,你需要在命令的末尾指定提交的校验和(或部分校验和):
$ git tag -a v1.2 9fceb02
可以看到你已经在那次提交上打上标签了:
$ git tagv0.1v1.2v1.3v1.4v1.4-lwv1.5
注意,标签不是按时间顺序列出,而是按字母排序的。可以用
git show
查看标签信息:
$ git show v1.2tag v1.2Tagger: Scott Chacon <schacon@gee->Date: Mon Feb 9 15:32:16 -0800version 1.2commit 9fceb02d0ae598e95dc970b74767f19372d61af8Author: Magnus Chacon <mchacon@gee->Date: Sun Apr 27 20:43:35 -0700updated rakefile
4. 推送标签到远程分支
默认情况下,git push
命令并不会传送标签到远程仓库服务器上。在创建完标签后你必须显式地推送标签到共享服务器上。这个过程就像共享远程分支一样 - 你可以运行
git push origin [tagname]
$ git push origin v1.5Counting objects: 14, done.Delta compression using up to 8 pressing objects: 100% (12/12), done.Writing objects: 100% (14/14), 2.05 KiB | 0 bytes/s, done.Total 14 (delta 3), reused 0 (delta 0)To git@:schacon/simplegit.git* [new tag] v1.5 -> v1.5
如果想要一次性推送很多标签,也可以使用带有--tags
选项的git push
命令。这将会把所有不在远程仓库服务器上的标签全部传送到那里。
$ git push origin --tagsCounting objects: 1, done.Writing objects: 100% (1/1), 160 bytes | 0 bytes/s, done.Total 1 (delta 0), reused 0 (delta 0)To git@:schacon/simplegit.git* [new tag] v1.4 -> v1.4* [new tag] v1.4-lw -> v1.4-lw
现在,当其他人从仓库中克隆或拉取,他们也能得到你的那些标签。
5. 检出标签
在Git
中你并不能真的检出一个标签,因为它们并不能像分支一样来回移动。如果你想要工作目录与仓库中特定的标签版本完全一样,可以使用
git checkout -b [branchname] [tagname]
在特定的标签上创建一个新分支:
$ git checkout -b version2 v2.0.0Switched to a new branch 'version2'
当然,如果在这之后又进行了一次提交,version2
分支会因为改动向前移动了,那么version2
分支就会和v2.0.0
标签稍微有些不同,这时就应该当心了。
检出标签的理解:是在这个标签的基础上进行其他的开发或操作。
检出标签的操作实质:是以标签指定的版本为基础版本,新建一个分支,继续其他的操作。
因此 ,就是新建分支的操作了。
$ git checkout -b [分支名称] [标签名称]
推荐检出代码后创建一个新的分支,否则你将会在一个用标签版本号命名的分支上。
6. 标签命令汇总
轻量级标签:git tag <tagname> commit_id
带说明标签:
git tag -a <tagname> commit_idgit tag -m <msg> <tagname> commit_id
带签名的标签(GPG加密,需安装配置):
git tag -s <tagname> commit_idgit tag -u <key-id> commit_id
查看标签:
git taggit tag –ngit show <tagname>
删除标签:
git tag -d <tagname>
向上游版本库提交标签:
如果要推送某个标签到远程,使用命令git push origin <tagname>
:
git push origin <tagname>git push origin --tags
或者,一次性推送全部尚未推送到远程的本地标签:
$ git push origin --tagsEnumerating objects: 1, done.Counting objects: 100% (1/1), done.Writing objects: 100% (1/1), 170 bytes | 170.00 KiB/s, done.Total 1 (delta 0), reused 0 (delta 0), pack-reused 0To :xiongjiamu/learing.git* [new tag] remove -> remove* [new tag] v0.1 -> v0.1* [new tag] v0.9 -> v0.9
如果标签已经推送到远程,要删除远程标签就麻烦一点,先从本地删除:
$ git tag -d removeDeleted tag 'remove' (was 1985ccf)
然后,从远程删除。删除命令也是push
,但是格式如下:
删除远程版本库的标签:
git push origin :tag2
$ git push origin :refs/tags/removeTo :xiongjiamu/learing.git- [deleted] remove