标签管理

如何在控制台为最新的提交创建标签？

1. 进入仓库列表。
2. 单击仓库名称进入仓库详情。
3. 单击“代码”页签下的“Tags”子页签，在这里可以看到标签列表。
4. 单击“新建”按钮，弹出新建标签页面如下图，选择要基于哪条分支或标签的最新版本进行标签的创建。
   

   说明：

   标签名称须满足如下要求：

   • 不支持以“-”、“.”、“refs/heads/”、“refs/remotes/”、“/”开头。
   • 不支持空格和[ \ < ~ ^ : ? * ! ( ) ' " | $ & ;等特殊字符。
   • 不支持以“.”、“/”、“.lock”结尾。
   • 不能有两个连续的点“..”。
   • 不能包含序列“@{”。

   如果在描述中输入信息会生成附注标签（描述相当于 -m 后的内容），不输入则生成轻量标签。（什么是附注标签？）

   当仓库中已存在同名称的分支/Tag或者上级分支/Tag时，则该Tag不可被创建。

5. 单击“确定”按钮，即可基于某个分支的最新版本生成标签，页面跳转到标签列表。

如何在控制台为历史版本创建标签？

1. 进入仓库列表。
2. 单击仓库名称进入仓库详情。在“代码”页签中，单击“文件 > 历史”页签。
3. 在历史列表中的某条提交记录中，单击，选择“新建Tag”，弹出为历史版本新建标签的弹窗。
   说明：

   如果在描述中输入信息会生成附注标签（描述相当于 -m 后的内容），不输入则生成轻量标签。（什么是附注标签？）

4. 单击“确定”按钮，即可基于某个指定历史版本生成标签，页面跳转到标签列表。

在控制台管理标签

• 在控制台的标签列表中，可查看该远程仓库中的全量标签并进行如下操作。
  

  • 单击“标签名”，跳转到该标签对应版本的文件列表。
  • 单击“提交号”，跳转到该次提交（commit）的详情页面。
  • 单击，可下载tar.gz或zip格式的被标签版本的文件包。
  • 单击，可以将此标签从代码托管仓库删除（想从本地删除请clone、pull或本地手动-d删除）。
  须知：

  如果仓库设置IP白名单，则只有IP白名单内的机器才可以在界面下载仓库源码，如果仓库没有设置IP白名单，则均可在界面下载仓库源码。

• 在控制台创建分支时，您可以选择基于某个标签去创建分支。

• 在控制台中，单击“代码”页签，单击目标文件的“文件名称”，单击文件的“对比”页签，可在该文件的提交记录之间做差异对比。

  

标签的分类

Git提供的标签类型分为两种：

• 轻量级标签：仅是一个指向特定commit的引用，可以理解为给特定commit起了一个别名。

  git tag <您给标签起的名称>

  如下图是一个轻量标签被查看详情时的显示内容，可以看到它其实就是一次commit的别名。

  

• 附注标签：指向一个特定的commit，但在Git中被作为一个完整对象存储，相比于轻量标签，附注标签可以为标签附上说明，类似代码的注释功能，方便注解标签。在标签信息的记录中，除包括标签名、附注标签说明外，同时包含了打标签者名字、电子邮件地址、打标签时间/日期。

  git tag -a  <您给标签起的名称> -m <"您给标签编写的说明">

  如下图是一个附注标签被查看详情时的显示内容，它指向了一次commit，相对于轻量标签它包含了更多的信息。

  

说明：

两种标签都可进行版本标识，附注标签包含了更多的信息，同时其在Git中也以更稳定安全的结构被存储，被更多的应用于大型企业与项目中。

关于标签的常用Git命令

• 新建轻量标签

  git tag <您给标签起的名称>       #为当前最新的提交打上轻量标签

  示例如下：

  git tag myTag1                   #为当前最新的提交上名称为 myTag1 的轻量标签
• 新建附注标签

  git tag -a  <您给标签起的名称> -m <"您给标签编写的说明">          #为当前最新的提交打上附注标签

  示例如下：

  git tag -a myTag2 -m "This is a tag." #为当前最新的提交打上名称为 myTag2 的附注标签,标签的备注信息为 This is a tag.
• 为历史版本打标签
  也可以对于历史版本打标签，只要使用给git log命令获取到历史版本的commit ID就行，以附标签为例，其操作如下。

  git log                 #会显示历史提交信息,获取commitID如下图,只取前几位即可，按 q 返回

  

  git tag -a historyTag -m "Tag a historical version." 6a5b7c8db    #为commitID为6a5b7c8d开头的历史版本打上一个标签，名称为 historyTag，备注为 Tag a historical version.
  说明：

  • 执行完新建标签操作，如果无回显则是创建成功，如果有回显一般是标签名称重复（回显如下图），更换标签名称重新执行即可。

    

  • Git支持为一次commit打上多个标签，其在log中显示如下图，标签名不能重复。

    

如何使用标签找回历史版本

当您要查看某个标签指向版本的代码时，可以将其检出到工作区。由于被检出的版本仅隶属于标签，而不属于任何分支，因此该代码可以编辑，但是不能add、commit。您可以基于工作区新建一条分支，在此分支上修改代码，并将此分支合入主干。具体的操作步骤如下所示。

1. 通过标签检出历史版本。

   git checkout V2.0.0                 #将被标签为 V2.0.0 的版本检出到工作区

   

2. 基于当前的工作区新建一条分支并切换到其中。

   git switch -c  forFixV2.0.0         #新建一条名为 forFixV2.0.0 的分支，并切换到其中                

   

3. （可选）如果修改了新建的分支的内容，需要将修改内容提交到该分支的版本库中。

   git add .                           #将修改添加到新分支的暂存区
   git commit -m "fix bug for V2.0.0"  #将修改内容存入该分支的版本库

   

4. 切换到master分支，并将新建立的分支合入（本示例中为 forFixV2.0.0 分支）。

   git checkout master                #切换到master分支
   git merge forFixV2.0.0             #将基于历史版本的修改 合入到master分支
   

   说明：

   以上命令旨在帮助您理解通过标签找回历史版本的过程原理，请根据原理自行裁剪增补Git命令以完成您在特定场景下需要的操作，不建议全流程直接复制使用。