DAG总览 / 组目录 / 版本管理

标签(Tag)

G02Layer 3
目录:前置概念账号与仓库版本管理协作项目管理自动化部署工具生态
层导航:L0L1L2L3 当前L4L5L6L7L8
上游 · 理解本功能前需先掌握的(1):
下游 · 依赖/承接本功能的(1):
前置依赖包含从属概念升级流程承接 边方向 = 学习顺序(A→B 表示先学 A 再学 B)

为什么需要它

心智模型

提交历史会越来越长,但你真正关心的'里程碑时刻'其实没几个。标签(tag)就是给特定提交贴的'纪念标签',常与版本号对应,比如 v1.0、v2.3.1。它让你能瞬间定位到某个重要版本。

历史背景 · 它为什么诞生诞生于 2005
诞生版本发布需要给历史特定点打标记(v1.0/v2.0),Git提供轻量(指针)与附注(完整对象、可签名)两种tag,用于标记发布点。
📚 历史依据(可溯源):
https://git-scm.com/book/en/v2/Git-Basics-Tagging

功能介绍

标签(tag)是贴在某个特定提交(commit)上的固定标记,用来标出历史中的重要节点,最常见的用途是标注版本号(version number),如 v1.0、v1.2.0。与分支不同,标签指向后通常不再移动,是一个'冻结'的锚点。Git 的标签分两种:轻量标签(lightweight tag)只是指向某个提交的名字;带注解标签(annotated tag)则额外记录标签创建者、日期和说明文字,发布版本时推荐使用后者。标签常与 release(发布)配套:给某个提交打上 v1.0 的标签,再基于它创建 Release,下载者就能拿到一个明确的版本。查看标签历史,你就拥有了项目的'版本时间线'。

核心术语

标签(tag):指向特定提交的固定标记版本号(version number):如 v1.0 的发布序号轻量标签(lightweight tag):只含名字的简单标签带注解标签(annotated tag):附带作者、日期和说明的完整标签里程碑(milestone):标签标记出的重要历史节点

适用场景

怎么操作(网页 vs 命令行 双轨)

🖱️ 网页操作 (GitHub.com)
  • 打开仓库 'Releases' 页面,点击 'Create a new release'
  • 在 'Choose a tag' 中输入版本号(如 v1.0.0)即可创建标签
  • 在 'Tags' 标签页查看所有标签及其指向的提交
⌨️ 命令行 (进阶)
  • git tag v1.0.0 # 为当前提交创建轻量标签
  • git tag -a v1.0.0 -m "第一个稳定版本" # 创建带注解标签
  • git tag # 列出所有标签
  • git push origin v1.0.0 # 把标签推送到远程仓库

新手建议先从网页操作入手,熟悉概念后再尝试命令行。命令行是真实开发中更常用的方式。

与其他功能的关系

关系(前置依赖 / 包含从属 / 概念升级 / 流程承接)说明
包含从属提交(Commit)tag 标记某个 commit 作为历史节点
前置依赖发布(Release)Release 基于 Git tag 打包发布物

官方文档

小结

SUMMARY

标签是给提交打的'固定纪念牌',常与 v1.0 这样的版本号对应,是版本的锚点。打好标签,别人就能精确下载你发布的版本。下一步:把标签变成真正的发布(Release)。