一般会给提交历史打个标签,方便后续进行筛选、查看
可带上可选的 -l
选项 --list
$ git tag
v1.0
v2.0
这个命令以字母顺序列出标签
例如,Git 代码仓库包含标签的数量超过 500 个,只想查 v1.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
v1.8.5.2
v1.8.5.3
v1.8.5.4
v1.8.5.5
很像一个不会改变的分支,它只是某个特定提交的引用
在运行 tag
命令时指定 -a
选项
$ git tag -a v1.4 -m "my version 1.4"
$ git tag
v0.1
v1.3
v1.4
-m
选项指定了一条将会存储在标签中的信息,如果不加,就会要求你手动输入
通过使用 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
输出显示了打标签者的信息、打标签的日期时间、附注信息,然后显示具体的提交信息
本质上是将提交校验和(SHA,那串很长的乱码)存储到一个文件中,没有保存任何其他信息
不需要使用 -a
、-s
或 -m
选项,只需要提供标签名字
$ git tag v1.4-lw
$ git tag
v0.1
v1.3
v1.4
v1.4-lw
v1.5
这时,如果在标签上运行 git show
,你不会看到额外的标签信息。 命令只会显示出提交信息
$ git show v1.4-lw
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date: Mon Mar 17 21:52:11 2008 -0700
changed the version number
也可以对提交历史打标签
假设提交历史是这样的
$ git log --pretty=oneline
15027957951b64cf874c3557a0f3547bd83b3ff6 Merge branch 'experiment'
a6b4c97498bd301d84096da251c98a07c7723e65 beginning write support
0d52aaab4479697da7686c15f77a3d64d9165190 one more thing
6d52a271eda8725415634dd79daabbc4d9b6008e Merge branch 'experiment'
0b7434d86859cc7b8c3d5e1dddfed66ff742fcbc added a commit function
4682c3261057305bdd616e23b64b0857d832627b added a todo file
166ae0c4d3f420721acbb115cc33848dfcc2121a started write support
9fceb02d0ae598e95dc970b74767f19372d61af8 updated rakefile
964f16d36dfccde844893cac5b347e7b3d44abbc commit the todo
8a5cbc430f1a9c3d00faaeffd07798508422908a updated readme
现在,假设在 v1.2 时你忘记给项目打标签,也就是在 “updated rakefile” 的提交历史
你可以在之后补上标签。 要在那个提交上打标签,你需要在命令的末尾指定提交的校验和(或部分校验和)
git tag -a v1.2 9fceb02
$ git tag
v0.1
v1.2
v1.3
v1.4
v1.4-lw
v1.5
$ git show v1.2
tag v1.2
Tagger: Scott Chacon <schacon@gee-mail.com>
Date: Mon Feb 9 15:32:16 2009 -0800
version 1.2
commit 9fceb02d0ae598e95dc970b74767f19372d61af8
Author: Magnus Chacon <mchacon@gee-mail.com>
Date: Sun Apr 27 20:43:35 2008 -0700
updated rakefile
...
git push
命令并不会传送标签到远程仓库服务器上git push <remote> <tagname>
polo@B-J5D1MD6R-2312 watermarker % git push origin2 1.11
枚举对象中: 17, 完成.
对象计数中: 100% (17/17), 完成.
使用 12 个线程进行压缩
压缩对象中: 100% (12/12), 完成.
写入对象中: 100% (14/14), 1.47 KiB | 1.47 MiB/s, 完成.
总共 14(差异 6),复用 0(差异 0),包复用 0
remote: Powered by GITEE.COM [GNK-5.0]
To gitee.com:poloyy/watermarker.git
* [new tag] 1.11 -> 1.11
如果想要一次性推送很多标签,也可以使用带有 --tags
选项的 git push
命令。 这将会把所有不在远程仓库服务器上的标签全部传送到那里。
git push origin2 --tags
枚举对象中: 6, 完成.
对象计数中: 100% (6/6), 完成.
使用 12 个线程进行压缩
压缩对象中: 100% (4/4), 完成.
写入对象中: 100% (5/5), 452 字节 | 452.00 KiB/s, 完成.
总共 5(差异 2),复用 0(差异 0),包复用 0
remote: Powered by GITEE.COM [GNK-5.0]
To gitee.com:poloyy/watermarker.git
* [new tag] 1.2 -> 1.2
* [new tag] 1.3 -> 1.3
现在,当其他人从仓库中克隆或拉取,他们也能得到这些标签
删除掉本地仓库上的标签,加个 -d 就行
polo@B-J5D1MD6R-2312 watermarker % git tag
1.11
1.2
1.3
testbu
v1.1
polo@B-J5D1MD6R-2312 watermarker % git tag -d 1.11
已删除标签 '1.11'(曾为 9baca61)
polo@B-J5D1MD6R-2312 watermarker % git tag -d 1.2
已删除标签 '1.2'(曾为 e4da7ac)
polo@B-J5D1MD6R-2312 watermarker % git tag -d 1.3
已删除标签 '1.3'(曾为 bf12eaa)
polo@B-J5D1MD6R-2312 watermarker % git tag
testbu
v1.1
-d 删除标签并不会从任何远程仓库中删除这个标签
$ git push origin --delete <tagname>
简单粗暴的方式
栗子
polo@B-J5D1MD6R-2312 watermarker % git push origin2 --delete 1.2
remote: Powered by GITEE.COM [GNK-5.0]
To gitee.com:poloyy/watermarker.git
- [deleted] 1.2
polo@B-J5D1MD6R-2312 watermarker % git push origin2 --delete 1.3
remote: Powered by GITEE.COM [GNK-5.0]
To gitee.com:poloyy/watermarker.git
- [deleted] 1.3
git push <remote> :refs/tags/<tagname>
将冒号前面的空值推送到远程标签名,从而高效地删除它
栗子
polo@B-J5D1MD6R-2312 watermarker % git push origin2 :refs/tags/1.11
remote: Powered by GITEE.COM [GNK-5.0]
To gitee.com:poloyy/watermarker.git
- [deleted] 1.11
git checkout
命令polo@B-J5D1MD6R-2312 watermarker % git status
头指针分离于 testbu
无文件要提交,干净的工作区
polo@B-J5D1MD6R-2312 watermarker % git checkout testbu
注意:正在切换到 'testbu'。
您正处于分离头指针状态。您可以查看、做试验性的修改及提交,并且您可以在切换
回一个分支时,丢弃在此状态下所做的提交而不对分支造成影响。
如果您想要通过创建分支来保留在此状态下所做的提交,您可以通过在 switch 命令
中添加参数 -c 来实现(现在或稍后)。例如:
git switch -c <新分支名>
或者撤销此操作:
git switch -
通过将配置变量 advice.detachedHead 设置为 false 来关闭此建议
HEAD 目前位于 7fa175d test
polo@B-J5D1MD6R-2312 watermarker % git branch
* (头指针在 1.2 分离)
master
能看到执行 git checkout 之后,本地分支会自动切换到头指针分支
polo@B-J5D1MD6R-2312 watermarker % git push
fatal: 您当前不在一个分支上。
现在为推送当前(分离头指针)的历史,使用
git push origin HEAD:<远程分支名字>
需要指定远程分支的哈希(就是那串很长的乱码字符串)
因此,如果你需要进行更改,比如你要修复旧版本中的错误,那么通常需要创建一个新分支
polo@B-J5D1MD6R-2312 watermarker % git checkout -b newtest3 1.2
切换到一个新分支 'newtest3'
polo@B-J5D1MD6R-2312 watermarker % git branch
master
newtest2
* newtest3