5.2创建标签

我会带着你远行 2022-06-05 12:41 114阅读 0赞

### 目标： ###

> 命令git tag 用于新建一个标签，默认为HEAD，也可以指定一个commit id；
> 
> git tag -a -m “blablabla…”可以指定标签信息；
> 
> 可以用git show 查看标签信息
> 
> git tag -s -m “blablabla…”可以用PGP签名标签；
> 
> 命令git tag可以查看所有标签。

### **创建标签:** ###

在Git中打标签非常简单，首先，切换到需要打标签的分支上：

$ git branch
    * dev
      master
    $ git checkout master
    Switched to branch 'master'

然后，敲命令git tag 就可以打一个新标签：

$ git tag v1.0

可以用命令git tag查看所有标签：

$ git tag
    v1.0

默认标签是打在最新提交的commit上的。有时候，如果忘了打标签，比如，现在已经是周五了，但应该在周一打的标签没有打，怎么办？

方法是找到历史提交的commit id，然后打上就可以了：

$ git log --pretty=oneline --abbrev-commit
    7966549 (HEAD -> master, tag: v1.0, origin/master) merged bug fix 101
    5aa1d8d fix bug 101
    b7df063 merged bug fix 101
    404aa69 fix bug 101
    82b72cf merge with no-ff
    7818c51 add merge
    d38947f conflict fixed
    3dba5f8 & simple
    c0dc45a AND simple
    227fd3f branch test
    15a9157 add text.txt
    0d083a9 remove test.txt
    5b10e1d add test
    1f12365 git tracks changes of giles
    a0731f8 git tracks changes
    924d61c understand how stage works
    9e3abb3 append GPL
    ebd8628 add distributed
    cdedb6c worte a readme file

比方说要对add merge这次提交打标签，它对应的commit id是7818c51，敲入命令：

$ git tag v0.9 7818c51

再用命令git tag查看标签：

$ git tag
    v0.9
    v1.0

注意，标签不是按时间顺序列出，而是按字母排序的。可以用git show 查看标签信息：

$ git show v0.9
    commit 7818c513a1bed98302c7899bdd8a2930a8b5273c (tag: v0.9)
    Author: *** <***@163.com>
    Date:   Tue Nov 21 17:55:23 2017 +0800
    
        add merge
    
    ...

可以看到，v0.9确实打在add merge这次提交上。

还可以创建带有说明的标签，用-a指定标签名，-m指定说明文字：

$ git tag -a v0.1 -m "version 0.1 released" 3628164

用命令git show 可以看到说明文字：

$ git show v0.1
    tag v0.1
    Tagger: *** <***@163.com>
    Date:   Tue Nov 28 10:24:35 2017 +0800
    
    version 0.1 released
    
    commit 796654943d87e7e3d33dfac90da165ec1da702ce (HEAD -> master, tag: v1.0, tag: v0.1, origin/master)
    Merge: b7df063 5aa1d8d
    Author: lyj <lyj79613@163.com>
    Date:   Mon Nov 27 21:34:03 2017 +0800
    
        merged bug fix 101

还可以通过-s用私钥签名一个$ git tag -s v0.2 -m “signed version 0.2 released” fec145a用PGP签名，因此，必须首先安装gpg（GnuPG），如果没有找到gpg，或者没有gpg密钥对，就会报错：

gpg: signing failed: secret key not available
    error: gpg failed to sign the data
    error: unable to sign the tag

如果报错，请参考GnuPG帮助文档配置Key。

用命令git show 可以看到PGP签名信息：

$ git show v0.2
    tag v0.2
    Tagger: Michael Liao <askxuefeng@gmail.com>
    Date:   Mon Aug 26 07:28:33 2013 +0800
    
    signed version 0.2 released
    -----BEGIN PGP SIGNATURE-----
    Version: GnuPG v1.4.12 (Darwin)
    
    iQEcBAABAgAGBQJSGpMhAAoJEPUxHyDAhBpT4QQIAKeHfR3bo...
    -----END PGP SIGNATURE-----
    
    commit fec145accd63cdc9ed95a2f557ea0658a2a6537f
    Author: Michael Liao <askxuefeng@gmail.com>
    Date:   Thu Aug 22 10:37:30 2013 +0800
    
        branch test

用PGP签名的标签是不可伪造的，因为可以验证PGP签名。验证签名的方法比较复杂，这里就不介绍了。