Git入门之标签

简介

本文系统地介绍了 Git 中与标签（Tag）相关的操作，适合刚接触 Git 的新手或希望掌握版本管理技巧的开发者阅读。标签是版本控制中的一个重要功能，它可以为某次提交打上具有意义的标记，便于版本识别和管理。博客通过4个实训关卡，从创建本地标签、推送标签到远程仓库、推送所有标签，再到删除本地标签，逐步引导读者掌握 Git 标签的常用命令与操作流程。每一关都配有详细的背景介绍、命令解释和脚本编写任务，让读者不仅能理解概念，还能通过实践加深印象。通过这种任务驱动式的学习方式，读者将逐步建立起标签操作的完整知识体系，为日后的项目协作与版本控制打下坚实基础。

第1关：创建标签

任务描述

现在你已经成了项目负责人，由你负责发布版本，你需要在发布一个版本之前，给该版本对应的代码打上标签，以便于管理和标识。

本关任务：为最近一次提交打上标签。

相关知识

在开发过程中，commit ID是一串无序的字符，它虽然能唯一标记一次代码提交，即一个版本。但是，它很难记忆和辨识。所以，为了给不同的版本起一个容易辨识的名字，我们可以给这次提交打上一个标签，用不同的标签来对应不同的版本。这样，就相当于给这次提交生成了一个快照。实际上，在为某次提交创建标签的时候，Git会为标签生成一个指针，以指向其对应的提交。然后，我们就可以通过标签找到对应的提交，这样对我们版本发布和代码审查都很有帮助。

如上图所示，我们为master分支上的三次提交，分别打上0.1、0.2、0.3三个标签。这样，当我们说0.1版本的时候，就对应了第一次提交的代码。这种方式大大降低了代码审查、团队交流及版本发布的复杂性。

查看标签

查看标签需要用到git tag命令，其具体使用示例如下:
git tag

这样就能列出所有的标签，显示的标签按字母顺序排列，所以标签的先后并不表示重要程度的轻重。

如果标签过多，而你指向显示指定的某些标签，则可以使用正则表达式：

git tag -l 'v5.1.2.*'

如上，使用-l参数，并使用v5.1.2.*这一正则表达式，就过滤除了符合要求的标签，其中v5.1.2.*为正则表达式，它能够匹配所有前缀为v5.1.2的标签。实际执行过程中会得到类似于下方的输出：

v5.1.2.1
v5.1.2.2
v5.1.2.3
v5.1.2.4

上方输出信息，为我们列出了目前版本库中已有的四个标签。

创建标签

不含附注的标签
创建标签的命令格式为：

git tag 标签名 commitID

参数commitID标识了该标签对应的代码版本，如果不提供commitID，就默认为最近一次提交后的代码打标签。例如：

git tag v1.0
git tag v1.0 7f8buir2

语句1表示，为最新一次提交后的代码打上v1.0的标签；语句2则表示，为指定的版本7f8buir2打上标签v1.0。

包含附注的标签
如果需要像提交代码时增加提交日志那样，为每个标签添加说明信息，则需要使用：

git tag -a 标签名 -m "说明信息"
如：

git tag -a v1.0 -m 'version 1.0'

表示为此次打的标签，增加一个version 1.0的说明信息。

在查看标签时，可以使用git show命令，查看某个标签的附注信息。例如：

git show v1.0

表示要查看标签v1.0对应的附注信息。

编程要求

本关的编程任务是，补全右侧代码片段中Begin至End中间的脚本，为最近一次提交打上标签v1.0。

本关涉及的脚本文件框架如下：

#创建gitTraining文件夹
mkdir gitTraining
#进入gitTraining文件夹
cd gitTraining
#将gitTraining初始化为一个本地仓库
git init
#创建helloGit.txt文件
touch helloGit.txt
#将helloGit.txt添加到暂存区
git add helloGit.txt
#将helloGit.txt提价到本地仓库
git commit -m "Git入门之标签实训第一关"
#请在下面的Bein/End星号线内填写Git命令为最近一次提交打上标签v1.0
#********** Begin **********#
#********** End **********#

测试说明
测试过程：

平台将执行用户补全的脚本；
平台通过程序，检测是否成功向本地仓库提交了helloGit.txt，并为提交打上标签v1.0；
接着根据检测结果，判断程序是否正确。
最难战胜的永远的是自己的内心，克服自己内心的恐惧是成功的基石。直面自己的内心，和自己对话！

开始你的任务吧，祝你成功！

代码文件

#创建gitTraining文件夹
mkdir gitTraining

#进入gitTraining文件夹
cd gitTraining

#将gitTraining初始化为一个本地仓库
git init

#创建helloGit.txt文件
touch helloGit.txt

#将helloGit.txt添加到暂存区
git add helloGit.txt

#将helloGit.txt提价到本地仓库
git commit -m "Git入门之标签实训第一关"

#请在下面的Bein/End星号线内填写Git命令为最近一次提交打上标签v1.0
#********** Begin **********#
git tag v1.0


#********** End **********#

思考

为什么使用标签而不是记住commit ID？

Git 的提交 ID 是一长串随机字符（如：7f8buir2），难以记忆，也不具备语义。打上 v1.0、release-2025 等标签后，我们就能直观地知道这个版本的意义。

轻量标签 vs. 附注标签的区别：

轻量标签：相当于一个书签，指向某个提交，没有额外信息；附注标签：包含创建者、时间戳、消息说明等元数据，更适合用于“版本发布”。

实用建议：

对于正式发布版本（如v1.0.0），建议总是使用 -a 创建附注标签，便于追踪；命名规范：尽量遵循语义化版本控制（SemVer）命名，例如 v1.2.3，便于自动化工具识别。

第2关：推送指定标签

任务描述

当你为某个版本打上标签后，就需要将其分享给团队中其他成员，即要将其推送至远程版本库。

本关任务：将指定标签推送至远程仓库。

相关知识

推送指定标签

推送指定标签到远程仓库的Git命令如下：

git push 远程主机名 tag名

其中，远程主机名为远程Git版本库对应的主机名，tag名为准备推送的标签名。

该命令使用示例如下：

git push origin v1.0

该语句表示将v1.0标签，推送到主机名为origin对应的远程仓库。

推送全部标签

推送指定标签需要用到：

git push 远程主机名 --tags

其使用方法如下：

git push origin --tags

其中origin为远程主机名，这样就能将全部标签推送至远程仓库。

编程要求

平台已经为你准备了本地仓库，进行了两次提交，并为这两次提交依次打上了v1.0、v2.0标签，本地仓库的远程仓库地址为/tmp/educoder.git，主机名为origin。

本关的编程任务是，补全右侧代码片段中Begin至End中间的脚本，将本地仓库的v1.0标签推送至远程仓库origin。

本关涉及的脚本文件框架如下：

#进入gitTraining文件夹
cd gitTraining
#请在下面的Bein/End星号线内填写Git命令为将标签v1.0推送至远程仓库
#********** Begin **********#
#********** End **********#

测试说明
测试过程：

平台将执行用户补全的脚本；
平台通过程序，检测是否成功向远程仓库推送了标签v1.0；
接着根据检测结果，判断程序是否正确。

代码文件

#进入gitTraining文件夹
cd gitTraining

#请在下面的Bein/End星号线内填写Git命令以将标签v1.0推送至远程仓库origin
#********** Begin **********#
git push origin v1.0

#********** End **********#

思考

为什么要推送标签？

标签默认只存在于本地。如果不推送到远程，其他团队成员是无法看到的。这对于团队协作和 CI/CD 构建都是不利的。

操作示例解释：

复制编辑

git push origin v1.0

上述命令将 v1.0 标签推送到远程名为 origin 的仓库。这里 origin 是默认的远程主机别名。

小贴士：

推送前可以先用 git tag 确认当前已有标签；若忘了推送某个标签，CI/CD流水线可能不会触发构建，务必确保关键版本标签已同步。

第3关：推送全部标签

任务描述

当你为版本打上标签后，就需要将其分享给团队中其他成员，即要将其推送至远程版本库。在前面的关卡中，我们已经学习了如何推送指定标签，但是在有些情况下，比如需要记录产品的各个版本的演变过程，或者和团队其他成员交流不同版本的代码，那么就需要将所有的标签全部推送。

本关任务：将全部标签推送至远程仓库。

相关知识

推送指定标签

推送指定标签，需要用到的命令格式为：

git push 远程主机名 tag名

其使用方法示例如下：

git push origin v1.0

其中origin为远程主机名，这样就能将v1.0推送至远程仓库。

推送全部标签

推送全部标签需要用到：

git push 远程主机名 --tags

其使用方法示例如下：

git push origin --tags

其中origin为远程主机名，这样就能将全部标签推送至远程仓库。

编程要求

平台已经为你准备了本地仓库gitTraining，然后进行了两次提交，并为这两次提交依次打上了v1.0、v2.0标签，本地仓库的远程仓库地址为/tmp/educoder.git，主机名为origin。

本关的编程任务是，补全右侧代码片段中Begin至End中间的脚本，将本地仓库的所有标签均推送至远程仓库origin。

本关涉及的脚本文件框架如下：

#进入gitTraining文件夹
cd gitTraining
#请在下面的Bein/End星号线内填写Git命令为将所有标签推送至远程仓库
#********** Begin **********#
#********** End **********#

测试说明
测试过程：

平台将执行用户补全的脚本；
平台通过程序，检测是否成功向远程仓库推送了全部标签；
接着根据检测结果，判断程序是否正确。

代码文件

#进入gitTraining文件夹
cd gitTraining

#请在下面的Bein/End星号线内填写Git命令为将所有标签推送至远程仓库
#********** Begin **********#

git push origin --tags
#********** End **********#

思考

实际应用场景：

发布多个历史版本时（例如同时打了v1.0、v2.0、v3.0），可以一次性推送；

初次克隆一个仓库并创建标签后，可用 git push origin --tags 统一上传。

命令解释：

复制编辑

git push origin --tags

这个命令会将本地所有标签推送到远程仓库。它不会推送还未被添加/提交的文件。

补充提示：

不建议频繁使用 --tags 推送测试用标签，以免污染远程仓库；建议在 .gitignore 或脚本中标注清楚哪些是“正式发布用”的标签。

第4关：删除标签

任务描述

当你为需要发布的版本打上了标签之后，你发现标签打错了，这个时候就需要将该标签删除。

本关任务：删除指定标签。

相关知识

删除本地标签

删除本地标签，需要用到的命令格式为：

　　git tag -d 标签名

具体使用方法示例如下：

　　git tag -d v1.0

这样就能实现删除v1.0标签。

删除远程标签

删除远程tag，可以使用如下命令：

git push origin --delete tag 标签名

或者如下所示的命令：

     git push origin :refs/tags/<tagname>

即推送一个空的tag名到远程仓库，其中<tagname>指某个标签的名字。

这两种方式都能实现删除远程的指定标签。

编程要求

平台已经为你准备了本地仓库gitTraining，远程主机名为origin，并进行了一次提交，且为这次提交打上了v1.0的标签。

本关的编程任务是，补全右侧代码片段中Begin至End中间的脚本，删除本地标签v1.0。

本关涉及的脚本文件框架如下：

#进入gitTraining文件夹
cd gitTraining
#请在下面的Bein/End星号线内填写Git命令以删除标签v1.0
#********** Begin **********#
#********** End **********#

测试说明
测试过程：

平台将执行用户补全的脚本；
平台通过程序，检测是否成功删除了本地标签v1.0；
接着根据检测结果，判断程序是否正确。

代码文件

#进入gitTraining文件夹
cd gitTraining

#请在下面的Bein/End星号线内填写Git命令以删除标签v1.0
#********** Begin **********#
git tag -d v1.0

#********** End **********#

思考

标签删除的常见原因：

标签拼写错误；

标签打在了错误的提交上；

标签不符合版本命名规范（如v1.01或v1_final_bugfix）。

删除远程标签的注意事项：

远程删除操作是危险操作，务必与团队成员沟通；

删除远程标签的推荐命令是：

git push origin --delete tag v1.0

或者

git push origin :refs/tags/v1.0

建议写法

# 删除本地标签
git tag -d v1.0

# 删除远程标签
git push origin --delete tag v1.0

总结

通过本博客的学习与实操练习，读者已掌握了 Git 中标签的核心操作流程，包括如何为最新提交打标签、如何将标签推送至远程仓库、如何一次性推送所有标签以及如何删除错误的标签。标签不仅能够清晰地标识项目的关键版本点，也为团队协作和版本发布提供了极大便利。在实际开发中，合理使用标签可以提升版本管理效率、简化部署流程。特别是在敏捷开发与持续集成的环境中，标签更是不可或缺的工具。希望通过本博客，读者能够熟练应用标签相关命令，在今后的项目中更加得心应手。同时也鼓励读者结合更多实际项目，将所学知识灵活运用，不断优化自己的版本控制技能，为职业成长助力。