Git tag

要创建新标记，请执行以下命令：

使用语义标识符替换 < tagname >，使其成为创建标记时代码存储库的状态。常见的模式是使用像 git tag v1.4 这样的版本号。Git 支持两种不同类型的标记：带注释的标记和轻量级标记。前面的示例创建了一个轻量级标记。轻量级标记和带注释的标记在存储的随附元数据量上有所不同。最佳实践是将带注释的标记视为公开标记，将轻量级标记视为私有标记。带注释的标记存储额外的元数据，例如：标记者姓名、电子邮件和日期。这是公开版本的重要数据。轻量级标记本质上是提交的“书签”，它们只是一个名称和指向提交的指针，可用于创建指向相关提交的快速链接。

执行此命令会创建一个标识为 v1.4-lw 的轻量级标记。轻量级标记是在没有 -a、-s 或 -m 选项的情况下创建的。轻量级标记会创建一个新的标记校验和并将其存储在 .git/ 项目代码存储库目录。

要列出代码存储库中存储的标签，请执行以下命令：

这将输出标记列表：

要细化标记列表，可以使用通配符表达式传递 -l 选项：

前面的示例使用了 -l 选项和 -rc 的通配符表达式，它返回标有 -rc 前缀的所有标记的列表，该前缀之前用于标识候选版本。

前面的标记示例演示了对隐式提交的操作。默认 git tag 会在 HEAD 引用的提交上创建一个标记。或者 git tag 可以作为对特定提交引用传递。这将标记传递的提交，而不是默认为 HEAD。要收集旧提交的列表，请执行 git log 命令。

执行 git log 将输出提交列表。在这个例子中，我们将为新标记选择提交量最高的 Merge branch 'feature'。我们需要引用提交的 SHA 哈希才能传递给 Git：

执行上述 git tag 调用将为我们在上一个 git log 示例中选择的提交创建一个标识为 v1.2 的新的带注释的提交。

如果您尝试使用与现有标记相同的标识符创建标记，Git 会抛出一个错误，如下所示：

此外，如果您尝试使用现有的标记标识符标记较旧的提交，Git 会抛出同样的错误。

如果您必须更新现有标记，则必须使用 -f FORCE 选项。

执行上述命令会将 15027957951b64cf874c357a0f357bd83ff6 提交映射到 v1.4 标记标识符。它将覆盖 v1.4 标记的所有现有内容。

共享标记类似于推送分支。默认 git push 不会推送标记。标记必须明确传递给 git push。

要同时推送多个标记，请将 --tags 选项传递给 git push 命令。当其他用户克隆或提取代码存储库时，他们将收到新的标记。

您可以使用 git checkout 命令在标记处查看代码存储库的状态。

上面的命令将签出 v1.4 标记。这会使代码存储库处于游离的 HEAD 状态。这意味着所做的任何变更都不会更新标记。他们将创建一个新的游离的提交。这个新的游离的提交不会成为任何分支的一部分，只能通过提交 SHA 哈希直接访问。因此，在游离的 HEAD 状态下进行变更时，最好创建一个新分支。

删除标记是一项简单的操作。将 -d 选项和标记标识符传递给 git tag 会删除已识别的标记。

在此示例中，执行 git tag 以展示显示 v1、v2、v3 的标记列表，然后执行 git tag-d v1，删除 v1 标记。

总而言之，标记是一种用于创建 Git 代码存储库快照的附加机制。传统上，标记用于创建与软件发布周期相对应的语义版本号标识符标记。git tag 命令是创建、修改和删除标记的主要驱动命令。有两种类型的标记：带注释的标记和轻量级标记。带注释的标记通常是更好的做法，因为它们会存储有关标记的额外有价值的元数据。本文档中介绍的其他 Git 命令包括 git push 和 git checkout。访问他们的相应页面，了解有关扩展使用的讨论。