Git Tag 标签使用

一、Tag 是什么？有什么作用？

Tag（标签）是 Git 中用来为某个特定的提交打上永久标记的功能。它像一个书签，指向一个固定的快照。

主要作用

Tag vs Branch

二、准备工作

我们使用之前创建的 git-rollback-practice 仓库，如果没有，请按以下命令快速重建：

cd ~/Desktop
mkdir git-rollback-practice
cd git-rollback-practice
git init

# 创建初始文件并提交
echo "Version 1" > app.txt
git add app.txt
git commit -m "v1: initial app.txt"

echo "Version 2" >> app.txt
git commit -am "v2: add version 2 line"

echo "Version 3" >> app.txt
git commit -am "v3: add version 3 line"

# 查看提交历史
git log --oneline

确保有三个提交，记下最新的 commit ID（例如 3333333）。

三、Tag 核心操作实战

3.1 创建轻量标签（Lightweight Tag）

轻量标签只是一个指向特定提交的引用，不含额外信息。

git tag v1.0.0-lightweight

3.2 创建附注标签（Annotated Tag）—— 推荐

附注标签包含打标签人、日期、说明等信息，存储在 Git 对象库中。

git tag -a v1.0.0 -m "Release version 1.0.0: initial stable release"

• -a：表示附注标签
• -m：标签说明

3.3 给历史提交打标签

假设你发现 v0.9.0 应该对应第一次提交（1111111）：

git tag -a v0.9.0 1111111 -m "Beta version based on first commit"

3.4 查看所有标签

git tag

输出示例：

v0.9.0
v1.0.0
v1.0.0-lightweight

3.5 查看某个标签的详细信息

git show v1.0.0

会显示标签的元数据以及对应的提交差异。

3.6 推送标签到远程仓库

如果这个仓库已经关联了远程 GitHub 仓库（假设已配置），可以推送：

# 推送单个标签
git push origin v1.0.0

# 推送所有本地标签
git push origin --tags

3.7 删除标签

删除本地标签：

git tag -d v1.0.0-lightweight

删除远程标签：

git push origin --delete v1.0.0-lightweight

或者使用简化语法：

git push origin :refs/tags/v1.0.0-lightweight

3.8 检出标签（查看历史代码）

当你想查看某个版本发布时的代码状态：

git checkout v1.0.0

此时会进入 "分离头指针" 状态（detached HEAD），意味着你不在任何分支上，修改后如果直接提交会丢失。不要在分离头指针状态下开发。

如果想基于某个标签修复 bug，应该创建新分支：

git checkout -b hotfix-from-v1.0.0 v1.0.0

现在你就在 hotfix-from-v1.0.0 分支上，可以基于 v1.0.0 的代码进行修改。

3.9 回到最新分支

git checkout main

四、实战演练：模拟版本发布流程

步骤 1：完成功能开发，准备发布 v1.0.0

# 假设当前在 main 分支，所有功能已完成
git tag -a v1.0.0 -m "Release version 1.0.0"
git push origin v1.0.0

步骤 2：继续开发新功能，提交 v1.1.0

echo "Version 4" >> app.txt
git commit -am "feat: add version 4 line"
git tag -a v1.1.0 -m "Release version 1.1.0 with new feature"
git push origin v1.1.0

步骤 3：发现 v1.0.0 有紧急 bug，需要基于该版本创建修复分支

git checkout -b hotfix-1.0.0 v1.0.0
echo "Critical fix" >> app.txt
git commit -am "hotfix: fix critical bug in v1.0.0"
git tag -a v1.0.1 -m "Hotfix release 1.0.1"
git push origin v1.0.1

步骤 4：将 hotfix 合并回 main

git checkout main
git merge hotfix-1.0.0
git push origin main

步骤 5：查看所有标签及历史

git tag -l
git log --oneline --decorate

你会看到提交旁边显示了标签名称。