通常遵循的命名模式如下:
v<major>.<minor>.<patch>
major(主版本号):重大变化
minor(次要版本号):版本与先前版本兼容
patch(补丁号):bug修复
1. 展示标签
git tag // 在 Git 中列出已有的标签
2. 只列1.8.5系列
$ git tag -l 'v1.8.5*'
v1.8.5
v1.8.5-rc0
....
v1.8.5-rc1
3. 查看某一个标签的详细信息
git show <tag_name>
4. 列出以v1.
开头的所有tag
git tag -l "v1."
5. 创建标签
// 在本地创建新标签
git tag <tag_name>
// 为特定的commit创建标签
git tag <tagname> <commit_sha>
// 添加一个-a标志以创建一个带备注的标签
git tag -a <tagname> -m "<message>"
6. 推送标签
// 推送到远程仓库
git push origin --tags
// 推送指定标签
git push origin <tagname>
7. 切换标签
git checkout <tagname>
8. 删除标签
// 删除本地仓库指定标签
git tag -d <tagname>
// 删除远程仓库指定标签
git push origin :refs/tags/<tagname>
或
git push origin --delete <tagname>
9. 拉取标签
// 将远程仓库的标签拉取(同步)到当前分支
git fetch --tags
10. 检出标签
// 以标签指定的版本为基础版本,新建一个分支
git checkout -b <branch> <tagname>
下面是更详细的说明介绍,供参考:
1. 在 Git 中列出已有的标签
$ git tag
v0.1
v1.3
2. 如果只对 1.8.5系列感兴趣,可以运行:
$ 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
3.创建标签
Git 使用两种主要类型的标签:轻量标签(lightweight)与附注标签(annotated)。
轻量标签:很像一个不会改变的分支——它只是一个特定提交的引用。
附注标签:附注标签是存储在 Git 数据库中的一个完整对象。 它们是可以被校验的; 通常建议创建附注标签,这样你可以拥有以上所有信息;
a.
附注标签:(创建一个附注标签是很简单的)
$ git tag
v1.0
$ git tag -a v1.4 -m "my version 1.4"
$ git tag
v1.0
v1.4
使用 git show 命令可以看到标签信息与对应的提交信息:
(输出显示了打标签者的信息、打标签的日期时间、附注信息,然后显示具体的提交信息。)
$ git show v1.4
tag v1.4
Tagger: Ben Straub <ben@straub.cc>
Date: Sat May 3 20:19:12 2014 -0700
my version 1.4
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date: Mon Mar 17 21:52:11 2008 -0700
changed the version number
b.
轻量标签:( 轻量标签本质上是将提交校验和存储到一个文件中——没有保存任何其他信息)
只需要提供标签名字:
$ git tag v1.4-lw
$ git tag
v1.4
v1.4-lw
如果在标签上运行 git show,只会看到对应提交信息,你不会看到额外的标签信息:(只是把对应提交的信息给绑定了)
$ git show v1.4-lw
4.后期打标签(给历史提交打标签)
需要在命令的末尾指定提交的校验和(hash值):
$ git tag -a v1.3 9fceb02
$ git tag
v1.3
v1.4
v1.4-lw
$ git show v1.2 // 此时就可以看到给历史提交打上了标签了
5.共享标签(默认情况下,git push 命令并不会传送标签到远程仓库服务器上)
运行 git push origin [tagname]
$ git push origin v1.5
使用带有 --tags 选项的 git push 命令:(所有不在远程仓库服务器上的标签全部传送到那里)
$ git push origin --tags
当其他人从仓库中克隆或拉取,他们也能得到你的那些标签。
6.删除标签 git tag -d <tagname>
a. 可以删除掉一个轻量级标签: (要删除掉你本地仓库上的标签)
$ git tag -d v1.4-lw
Deleted tag 'v1.4-lw' (was e7d5add)
b. 同时远程分支的标签要进行推送更新:git push <remote> :refs/tags/<tagname>
$ git push origin :refs/tags/v1.4-lw
To /git@github.com:schacon/simplegit.git
- [deleted] v1.4-lw
7.检出标签(git checkout )
会使你的仓库处于“分离 头指针(detacthed HEAD)”状态;
在“分离头指针”状态下,如果你做了某些更改然后提交它们,标签不会发生变化,但你的新提交将不属于任何
分支,并且将无法访问,除非确切的提交哈希;
$ git checkout 2.0.0
Note: checking out '2.0.0'.
You are in 'detached HEAD' state. ........
创建一个新分支:
$ git checkout -b version2 v2.0.0
Switched to a new branch 'version2'
// 如果在这之后又进行了一次提交,version2 分支会因为这个改动向前移动,version2 分支就会和
v2.0.0 标签稍微有些不同,这时就应该当心了。