Git 入门系列(六)- 标签 tag

像其他版本控制系统一样,Git 可以给历史中的某一个提交点打上标签,以示重要。 比如功能开发完成后会使用这个功能来标记发布节点(如 v1.0 等)。本篇,就介绍下如何创建、删除标签等操作。

Tag 会指向一个 commit,就像一个分支的引用,但是不会变化(永远都指向同一个 commit,仅仅提供了一个更加友好的名字)

创建标签

Git 标签分为两种类型:轻量标签(lightweight)与附注标签(annotated)

  • 轻量标签:指向提交对象的引用(就像一个独立的分支)
  • 附注标签:仓库中一个独立的对象,还可以查看标签的信息(推荐使用)
    标签的信息:标签的名字、邮箱地址和日期、标签说明等。

轻量标签

轻量标签本质上是将提交校验和存储到一个文件中 —— 没有保存任何其他信息。
创建轻量标签,不需要传递参数,直接指定标签名即可 git tag <tagname>
如:git tag v1.0

附注标签

在 Git 中创建一个附注标签,需添加参数
git tag -a <tagname> -m <message>

  • -a 即 annotated 的缩写,指定标签类型,后面跟上标签名
  • -m 选型指定了标签的说明,如果没有给出该选项,Git 会启动文本编辑器供你输入标签说明。

打完标签之后,查看日志也能看到所打标签


列出标签

在 Git 中列出已有的标签是非常简单直观的。 只需要输入 git tag 即可
这个命令以字母顺序列出标签,但是它们出现的顺序并不重要。

Git 也支持列出符合特定模式的标签
例如,如果只关心对 0.x,可以运行:git tag -l 'v0.*'

这里支持 windows系统命令行中存在的最简单的正则表达式

  • * 任意长度的字符串
  • ?长度为1的任意字符串

查看标签

通过使用 git show <tagname> 命令可以看到标签信息与对应的提交信息:

  • 使用附注标签(exp:tag v0.2) 输出显示了打标签者的信息、打标签的日期时间、附注信息,然后显示具体的提交信息
  • 使用轻量标签(exp:tag v0.1)不会看到额外的标签信息


补打标签

前面的打标签方式,都针对当前提交处,Git 也支持对过去的提交打标签。 要在那个提交上打标签,只需要在命令的末尾指定提交commitid即可

  • 轻量标签 git tag <tagname> <commitid>
  • 附注标签 git tag -a <tagname> -m <message> <commitid>

现在,假设在 “feat_6 modify ”处, alpha版本 时你忘记给项目打标签,那么可以补打标签
git tag -a v0.1_alpha -m "release aplha 0.1" 35b473

可以看到已经在那次提交上打上标签了:


分享标签(推送到远程)

默认情况下,git push 并不会把标签推送到远端服务器上,只有通过显式命令才能分享标签到远端仓库。其命令格式如同推送分支,执行 git push origin <tagname> 即可:


在 GitHub 也看到有一个标签

点进去可看到标签详情

如果要一次推送所有(本地新增的)标签上去,可以使用 --tags 选项:
git push origin --tags 那么远程端会同步所有未 push 过的标签。


现在,当其他人从仓库中 clone 或者 pull,也能看到这些远程标签

删除标签

要删除掉你本地仓库上的标签,可以使用命令 git tag -d <tagname>。例如,可以使用下面的命令删除掉一个标签:

需要注意上述命令并不会远程仓库中移除这个标签,你必须使用 git push <remote> :refs/tags/<tagname> 来更新你的远程仓库:
删除远程仓库中的 v0.1 标签 git push origin :refs/tags/v0.1

这里的<remote> 是origin,其实每个本地仓库也可以有多个远程仓库的

检出标签(切换标签)

如果你想查看某个标签所指向的文件版本,可以使用 git checkout <tagname> 命令,Git 会检出指定版本,但是并没有在分支内。这叫做一个 "detacthed HEAD",会使仓库处于“分离头指针”状态,这意味着 HEAD 文直接指向一个提交,而不是一个符号引用。

我们从 v0.1_alpha 检出 git chckout v0.1_alpha

当前从标签 v0.1_alpha 检出的并不是一个新的分支,而是一个分离头指针状态

在 “分离头指针” 状态下,如果做了某些更改然后提交它们,标签不会发生变化,但你的新提交将不属于任何分支,并且将无法访问,除非确切的提交哈希。因此,如果你需要进行更改——比如说你正在修复旧版本的错误——这通常需要创建一个新分支:

git checkout -b <new_branch>

当然,如果在这之后又进行了一次提交,这个分支会因为这个改动向前移动,新分支就会和 v0.1_alpha 标签稍微有些不同。

参考理解:我自己会将 detacthed HEAD state 理解成一个灰色地带,能够单独检出,但是做的事情无法保存,最好回到分支上处理

回顾总结

本篇介绍了 tag 命令的使用,良好的使用 tag 能够更直观的进行版本管理
创建标签

  • git tag <tagname> 创建轻量标签
  • git tag -a <tagname> -m <message> 创建附注标签(推荐)

列出标签

  • git tag [-l] 列出标签
  • git tag -l [tagname] 列出指定模式的标签,可以用简单的正则,如 v0.*

查看标签

  • git show <tagname> 查看指定标签

补打标签

  • git tag <tagname> <commitid> 补打轻量标签
  • git tag -a <tagname> -m <message> <commitid> 补打附注标签

分享标签(远程标签)

  • git push origin <tagname> 本地标签推送至远端
  • git push origin --tags 推送所有的本地标签至远端

删除标签

  • git tag -d <tagname> 删除本地标签
  • git push <remote> :refs/tags/<tagname> 删除远端标签

检出标签

  • git checkout <tagname> 但不建议直接在检出后环境(分离头指针状态)更新,通常会创建新分支来处理,但 tag 的指向不会变化

系列文章传送门

Git 入门系列(一)- Git 概念/安装/基本操作/远程推送更新
Git 入门系列(二)- 修改管理 / 撤销操作 / 命令及区间关系
Git 入门系列(三)- 分支(上)创建与切换 / 合并 / 查看 / 删除
Git 入门系列(四)- 分支(下)合并解决冲突 / 远程分支
Git 入门系列(五)- stash 贮藏
Git 入门系列(六)- 标签 tag
Git 入门系列(七)- 可视化 Git 管理工具
Git 入门系列(八) - FAQ

欢迎关注个人公众号,【程序媛春哥的手记】


最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,761评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,953评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,998评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,248评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,130评论 4 356
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,145评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,550评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,236评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,510评论 1 291
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,601评论 2 310
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,376评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,247评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,613评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,911评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,191评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,532评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,739评论 2 335