随着开发的深刻,一些开发的标准也在缓缓落实。对我的项目的每个版本打上标签就是其中很重要的一项。本文用来记录打标签的一些惯例操作。
应用命令行提醒
应用命令行提醒查看 tag 相干命令行:
$ git tag -h
创立标签
通过 git tag <tagname>
创立一个标签:
$ git tag v1.0.0v1.0.0
默认标签是打在最新提交的commit上的。如果想给历史commit 打上标签,只需在前面加上 commit id 即可。
$ git tag v1.0.8 ba9f9e
上传标签
git push
并不会将 tag 推送到近程仓库服务器上,在创立完 tag 后咱们须要手动推送 tag。
推送单个 tag:
$ git push origin v1.0.8总共 0(差别 0),复用 0(差别 0),包复用 0To github.com:hellomrbigshot/react-m-editor.git * [new tag] v1.0.8 -> v1.0.8
一次推送所有本地 tag:
$ git push origin --tags总共 0(差别 0),复用 0(差别 0),包复用 0To github.com:hellomrbigshot/react-m-editor.git * [new tag] v1.0.6 -> v1.0.6 * [new tag] v1.0.7 -> v1.0.7 * [new tag] v1.0.8 -> v1.0.8
查看标签列表
通过 git tag
查看所有标签
$ git tagv2.0.0v1.0.6v1.0.5......
通过 git tag -l "v1.0*"
查看 1.0.x
版本的tag
$ git tag -l "v1.0*"v1.0.6v1.0.5......
git tag -l
等同于git tag --list
也能够应用 git tag --sort <key>
自定义 tag 排序
$ git tag --sort "tagger"
查看单个标签
应用 git show <tagname>
命令查看标签详细信息
$ git show v1.0.8commit 9f6866b4a1343a793b13809c2fc1b0b5daba9f9e (tag: v1.0.8)Author: hellomrbigshot <1994yechen@gmail.com>Date: Tue Apr 14 14:18:07 2020 +0800 ✨ add dark mode
删除标签
应用 git tag -d <tagname>
删除本地仓库上的标签:
$ git tag -d v1.0.9已删除标签 'v1.0.9'(曾为 fb8fd3e)
而后用 git push <remote> :refs/tags/<tagname>
更新近程仓库:
$ git push origin :refs/tags/v1.0.9To github.com:hellomrbigshot/react-m-editor.git - [deleted] v1.0.9
或者间接用 git push origin --delete <tagname>
间接删除近程标签:
$ git push origin --delete v1.0.7To github.com:hellomrbigshot/react-m-editor.git - [deleted] v1.0.7
而后同步到本地
$ git fetch --prune --prune-tags
留神:git fetch --prune --prune-tags
会强制同步近程 tag 到本地,所以会导致本地新建的未提交到近程服务器的 tag 也会被删除。
给标签增加信息
上文提到的创立标签属于创立轻量标签,咱们还能够在创立标签时通过-m <message>
增加附加信息:
$ git tag v2.0.0 -m "version 2.0.0 released"
这样就对最新的提交增加了一个带从属信息的 tag。
增加多行信息能够增加多个 -m "<message>"
$ git tag v2.0.0 -m "version 2.0.0 released" -m "rebuild with react hooks" -m "support typescript"
这时候能够用 git tag -n<n>
查看 n 行的 tag 信息:
$ git tag -n3 // 查看三行的 tag 信息v1.0.0 version 1.0.0 released support typescriptv1.0.6 version 1.0.6 released new versionv1.0.9 version 1.0.9 releasedv2.0.0 version 2.0.0 released
对于已有的tag,咱们想要编辑它的信息,除了删除这个tag从新打tag之外还能够用git tag <tagname> <tagname>^{} -f -m "<new message>"
批改 tag 信息:
$ git tag v1.0.0 v1.0.0^{} -f -m "first commit"已更新标签 'v1.0.0'(曾为 6991484)$ git show v1.0.0tag v1.0.0Tagger: hellomrbigshot <1994yechen@gmail.com>Date: Mon Aug 16 16:29:38 2021 +0800first commitcommit ab5666cfdf221c8a5b55b275b190fb8df440e985 (tag: v1.0.0)Author: hellomrbigshot <1994yechen@gmail.com>Date: Thu Aug 22 00:55:59 2019 +0800 version 1.0.0
此时如果线上曾经存在这个tag,咱们批改后想将它推送到近程代码仓库须要加 -f
强制推送:
$ git push origin v1.0.0To github.com:hellomrbigshot/react-m-editor.git ! [rejected] v1.0.0 -> v1.0.0 (already exists)error: 推送一些援用到 'github.com:hellomrbigshot/react-m-editor.git' 失败提醒:更新被回绝,因为该标签在近程曾经存在。$ git push origin -f v1.0.0枚举对象中: 1, 实现.对象计数中: 100% (1/1), 实现.写入对象中: 100% (1/1), 165 字节 | 165.00 KiB/s, 实现.总共 1(差别 0),复用 0(差别 0),包复用 0To github.com:hellomrbigshot/react-m-editor.git + 6991484...db8e1aa v1.0.0 -> v1.0.0 (forced update)
参考
Git - 打标签
git-tag