版本控制与协作 / 系统课时
使用标签标记发布版本
使用标签标记发布版本
学习目标
完成本课后,你将能够:
- 说明标签与分支的区别
- 创建轻量标签和附注标签
- 查看标签指向的提交与元数据
问题背景或应用场景
提交哈希适合机器定位,但不便于人类记忆和发布沟通。标签可以给重要提交赋予稳定名称,例如 v1.0.0。与会随提交前进的分支不同,标签通常固定指向发布节点。
核心原理
轻量标签只是一个直接指向提交的引用;附注标签会创建独立标签对象,包含创建者、时间和说明,也可以签名验证。正式发布通常更适合使用附注标签,因为元数据完整。
标签不会随着后续提交自动移动。若把已有发布标签改到另一个提交,会让不同成员对同一版本名称产生不同理解,因此发布标签应视为不可变标识。

基础用法
使用 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.0Tips
- 正式发布优先使用附注标签。
- 采用一致的语义化版本命名。
- 打标签前确认测试、构建和提交位置。
常见错误
1. 把标签当成开发分支
- 错误表现:打标签后继续期待它自动前进。
- 产生原因:标签通常是固定引用。
- 正确处理:继续开发应使用分支,发布节点使用标签。
- 修复结果:版本名称稳定指向同一提交。
2. 在错误提交上打标签
- 错误表现:发布内容与预期不一致。
- 产生原因:未检查当前 HEAD。
- 正确处理:创建前执行
git log -1和构建验证。 - 修复结果:标签准确指向已验证提交。
本课练习
1. 创建两类标签
- 任务目标:比较对象类型。
- 输入或初始条件:仓库有两个提交。
- 实现要求:分别创建轻量和附注标签。
- 验收条件:
cat-file -t输出不同类型。
2. 给历史提交打标签
- 任务目标:练习指定目标。
- 输入或初始条件:当前 HEAD 已超过目标发布提交。
- 实现要求:为旧提交创建版本标签。
- 验收条件:标签内容与指定旧提交一致。
3. 列出版本范围
- 任务目标:练习标签过滤。
- 输入或初始条件:存在多个
v1.*和v2.*标签。 - 实现要求:只列出
v1.*。 - 验收条件:结果不包含其他主版本。
按自己的节奏,确认真正理解。