随着开发的深刻,一些开发的标准也在缓缓落实。对我的项目的每个版本打上标签就是其中很重要的一项。本文用来记录打标签的一些惯例操作。

应用命令行提醒

应用命令行提醒查看 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