版本控制与协作 / 系统课时

使用标签标记发布版本

使用标签标记发布版本

学习目标

完成本课后,你将能够:

  • 说明标签与分支的区别
  • 创建轻量标签和附注标签
  • 查看标签指向的提交与元数据

问题背景或应用场景

提交哈希适合机器定位,但不便于人类记忆和发布沟通。标签可以给重要提交赋予稳定名称,例如 v1.0.0。与会随提交前进的分支不同,标签通常固定指向发布节点。

核心原理

轻量标签只是一个直接指向提交的引用;附注标签会创建独立标签对象,包含创建者、时间和说明,也可以签名验证。正式发布通常更适合使用附注标签,因为元数据完整。

标签不会随着后续提交自动移动。若把已有发布标签改到另一个提交,会让不同成员对同一版本名称产生不同理解,因此发布标签应视为不可变标识。

Git 标签与分支对比图

基础用法

使用 git tag v0.1.0 <提交> 创建轻量标签;使用 git tag -a v1.0.0 -m "release: v1.0.0" 创建附注标签。通过 git show v1.0.0、git tag --list 和 git cat-file -t 检查类型。

完整可运行示例

以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。

bash
rm -rf git-tag-demo
mkdir git-tag-demo
cd git-tag-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "version=0.1.0
" > app.txt
git add app.txt
git commit -q -m "feat: prepare version 0.1.0"
git tag v0.1.0
printf "version=1.0.0
" > app.txt
git add app.txt
git commit -q -m "release: version 1.0.0"
git tag -a v1.0.0 -m "release: v1.0.0"
printf "tags:
"
git tag --list --sort=version:refname
printf "lightweight-type: "
git cat-file -t v0.1.0
printf "annotated-type: "
git cat-file -t v1.0.0
printf "release-commit: "
git show -s --format=%s 'v1.0.0^{}'

预期输出

text
tags:
v0.1.0
v1.0.0
lightweight-type: commit
annotated-type: tag
release-commit: release: version 1.0.0

Tips

  • 正式发布优先使用附注标签。
  • 采用一致的语义化版本命名。
  • 打标签前确认测试、构建和提交位置。

常见错误

1. 把标签当成开发分支

  • 错误表现:打标签后继续期待它自动前进。
  • 产生原因:标签通常是固定引用。
  • 正确处理:继续开发应使用分支,发布节点使用标签。
  • 修复结果:版本名称稳定指向同一提交。

2. 在错误提交上打标签

  • 错误表现:发布内容与预期不一致。
  • 产生原因:未检查当前 HEAD。
  • 正确处理:创建前执行 git log -1 和构建验证。
  • 修复结果:标签准确指向已验证提交。

本课练习

1. 创建两类标签

  • 任务目标:比较对象类型。
  • 输入或初始条件:仓库有两个提交。
  • 实现要求:分别创建轻量和附注标签。
  • 验收条件:cat-file -t 输出不同类型。

2. 给历史提交打标签

  • 任务目标:练习指定目标。
  • 输入或初始条件:当前 HEAD 已超过目标发布提交。
  • 实现要求:为旧提交创建版本标签。
  • 验收条件:标签内容与指定旧提交一致。

3. 列出版本范围

  • 任务目标:练习标签过滤。
  • 输入或初始条件:存在多个 v1.* 和 v2.* 标签。
  • 实现要求:只列出 v1.*。
  • 验收条件:结果不包含其他主版本。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用标签标记发布版本

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通