Git标签管理

Myth丶恋晨 2022-09-22 13:53 145阅读 0赞

标签管理  
发布一个版本时，我们通常先在版本库中打一个标签，这样，就唯一确定了打标签时刻的版本。将来无论什么时候，取某个标签的版本，就是把那个打标签的时刻的历史版本取出来。所以，标签也是版本库的一个快照。

Git的标签虽然是版本库的快照，但其实它就是指向某个commit的指针（跟分支很像对不对？但是分支可以移动，标签不能移动），所以，创建和删除标签都是瞬间完成的。

1.创建标签

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

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

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

$ git tag v1.0

可以用 git tag查看所有的标签，

$ git tag
    v1.0

默认标签是打在最新提交的commit上的。有时候，如果忘了打标签，比如，现在已经是周五了，但应该在周一打的标签没有打，怎么办？  
方法是找到历史提交的commit id，然后打上就可以了：

$ git log --pretty=oneline --abbrev-commit
    47adae6 add merge
    6a36265 conflict fixed
    02a7369 & simple
    26e0710 AND simple
    7d5bd53 branch test
    610c2b0 上传test1.txt和test2.txt

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

$ git tag v0.9 47adae6

再用命令git tag查看标签：

Administrator@G3CUWWS80LUWCDG MINGW32 /f/Git/MyGitTest (dev)
    $ git tag v0.9 47adae6
    
    Administrator@G3CUWWS80LUWCDG MINGW32 /f/Git/MyGitTest (dev)
    $ git tag
    v0.9
    v1.0

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

$ git show v0.9
    commit 47adae63c5a1e88a590f79e738a971e5362903ac
    Author: shufacc <394324605@qq.com>
    Date:   Wed Jun 29 11:36:10 2016 +0800
    
        add merge
    
    diff --git a/test1.txt b/test1.txt
    index 1b289bd..4ba33c6 100644
    --- a/test1.txt
    +++ b/test1.txt
    @@ -2,3 +2,4 @@
     11111111111
     Creating a new branch is quick.
     Creating a new branch is quick and simple.
    +add merge test

可以看到， v0.9确实打在 add merge这次提交上。  
还可以创建带有说明的标签，用 \-a指定标签名， \-m指定说明文字：

$ git tag -a v0.8 -m "version 0.1 released" 6a36265

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

$ git show v0.8
    tag v0.8
    Tagger: shufacc <394324605@qq.com>
    Date:   Thu Jun 30 13:51:39 2016 +0800
    
    version 0.1 released
    
    commit 6a36265634b2802d08ff284094b2ada124a17808
    Merge: 02a7369 26e0710
    Author: shufacc <394324605@qq.com>
    Date:   Wed Jun 29 10:22:05 2016 +0800
    
        conflict fixed
    
    diff --cc test1.txt
    index 1b864d1,29c1ca3..1b289bd
    --- a/test1.txt
    +++ b/test1.txt
    @@@ -1,4 -1,4 +1,4 @@@
      111111
      11111111111
      Creating a new branch is quick.
    - Creating a new branch is quick & simple.
     -Creating a new branch is quick AND simple.

还可以通过 \-s用私钥签名一个标签：

签名采用PGP签名，因此，必须首先安装gpg（GnuPG），如果没有找到gpg，或者没有gpg密钥对，就会报错：

$ git tag -s v0.7 -m "signed version 0.7 released" 02a7369
    gpg: WARNING: using insecure memory!
    gpg: please see http://www.gnupg.org/documentation/faqs.html for more information
    gpg: directory `/c/Users/Administrator/.gnupg' created
    gpg: new configuration file `/c/Users/Administrator/.gnupg/gpg.conf' created
    gpg: WARNING: options in `/c/Users/Administrator/.gnupg/gpg.conf' are not yet active during this run
    gpg: keyring `/c/Users/Administrator/.gnupg/secring.gpg' created
    gpg: keyring `/c/Users/Administrator/.gnupg/pubring.gpg' created
    gpg: skipped "shufacc <394324605@qq.com>": secret key not available
    gpg: signing failed: secret key not available
    error: gpg failed to sign the data
    error: unable to sign the tag

如果报错，请参考GnuPG帮助文档配置Key。  
用命令 **git show <tagname>**可以看到PGP签名信息：

$ git show v0.7

用PGP签名的标签是不可伪造的，因为可以验证PGP签名。验证签名的方法比较复杂，这里就不介绍了。  
小结  
• 命令 **git tag <name>**用于新建一个标签，默认为HEAD，也可以指定一个commit id；  
•  **git tag -a <tagname> -m "blablabla..."**可以指定标签信息；  
•  **git tag -s <tagname> -m "blablabla..."**可以用PGP签名标签；  
• 命令 **git tag**可以查看所有标签。  
  
2.操作标签

如果标签打错了，也可以删除：

$ git tag -d v0.1
    Deleted tag 'v0.1' (was e078af9)

因为创建的标签都只存储在本地，不会自动推送到远程。所以，打错的标签可以在本地安全删除。  
如果要推送某个标签到远程，使用命令 **git push origin <tagname>**：

$ git push origin v1.0

或者，一次性推送全部尚未推送到远程的本地标签：

$ git push origin --tags

如果标签已经推送到远程，要删除远程标签就麻烦一点，先从本地删除：

$ git tag -d v0.9
    Deleted tag 'v0.9' (was 6224937)

然后，从远程删除。删除命令也是push，但是格式如下：

$ git push origin :refs/tags/v0.9

要看看是否真的从远程库删除了标签，可以登陆GitHub查看。  
小结  
• 命令 **git push origin <tagname>**可以推送一个本地标签；  
• 命令 **git push origin --tags**可以推送全部未推送过的本地标签；  
• 命令 **git tag -d <tagname>**可以删除一个本地标签；  
• 命令 **git push origin :refs/tags/<tagname>**可以删除一个远程标签。