【前端工程化指南】Git常见操作之标签相关操作

在Git中，标签（Tag）是用于标记特定提交的不可变引用，它们是版本控制中的一个重要概念，用于标识重要的里程碑、版本号或发布版本等。

与分支不同，标签是静态的，不会随着新的提交而移动。一旦创建了标签，它会始终指向特定的提交，不会自动更新。

Git中有两种类型的标签：轻量标签（Lightweight Tag） 和附注标签（Annotated Tag） 。

• 轻量标签（Lightweight Tag） ：轻量标签只是指向特定提交的引用。它们是最简单的标签形式，只是一个指针，没有额外的信息。创建轻量标签时，只需指定标签名称和目标提交即可。
• 附注标签（Annotated Tag） ：附注标签是包含额外信息的对象，其中包括标签的作者、创建日期、标签消息等。创建附注标签时，会创建一个独立的Git对象，存储标签的信息，并将其与特定提交关联。

标签的创建和使用可以帮助您在版本历史中标记重要节点，例如软件发布、里程碑完成等。它们提供了一个易于引用的指针，可以方便地访问特定的提交，下面我们具体学习标签相关的命令吧！

查看本地仓库标签列表

我们可以通过以下命令查看本地仓库的标签列表。

git tag [-l "<search_rule>"]

• -l "<search_rule>"（可选）：用于列出匹配特定模式的标签。例如，git tag -l "v1.*"将列出所有以"v1."开头的标签。

查看远程仓库标签列表

我们可以通过以下命令查看远程仓库的标签列表。

git ls-remote --tags <remote_repo>

• <remote_repo>（必须）：指定远程仓库，一般为origin。

查看标签详情

我们可以通过以下命令查看标签详情内容，包括与标签关联的提交、作者、日期和标签消息等。

git show <tag_name>

• <tag_name>（必须）：指定需要查看详情的标签名称。

创建轻量级标签

我们可以通过以下命令创建轻量级标签。

git tag <tag_name> [<commit_hash>]

• <tag_name>（必须）：指定创建的标签名称。
• <commit_hash>（可选）：指定为某次提交创建标签，不指定则默认为最近一次提交。

创建附注标签

我们可以通过以下命令创建附注标签。

git tag -a <tag_name> -m "<tag_message>" [<commit_hash>]

<tag_name>（必须）：指定创建的标签名称。

• "<tag_message>"（必须）：指定附注标签的消息。
• <commit_hash>（可选）：指定为某次提交创建标签，不指定则默认为最近一次提交。

创建远程仓库标签

在本地仓库创建好标签后，我们可以通过以下命令将添加的标签同步到远程仓库。

git push <remote_repo> <tag_name>

• <remote_repo>（必须）：指定远程仓库，一般为origin。
• <tag_name>（必须）：指定需要同步到远程仓库的标签名称。

删除本地仓库标签

我们可以通过以下命令删除本地仓库标签。

git tag -d <tag_name>

• <tag_name>（必须）：指定需要删除的标签名称。

删除远程仓库标签

我们可以通过以下命令删除远程仓库标签。

git push <remote_repo> --delete <tag_name>

• <remote_repo>（必须）：指定远程仓库，一般为origin。
• <tag_name>（必须）：指定需要删除的标签名称。

重新标记/替换旧标签

如果您尝试创建与现有标签具有相同标识符的标签，Git 将抛出如下错误：

fatal: tag 'v0.4' already exists

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

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

git tag -a -f v1.4 15027957951b64cf874c3557a0f3547bd83b3ff6

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

原文链接：
https://juejin.cn/post/7355394311674413108