Git 给 main 分支打 Tag（版本标记）完整教程

给 Git 的 main 分支打 Tag（标签） ，就是给当前代码版本做一个永久标记，后期可以一键切回这个版本，非常适合用于发布版本、备份关键版本。

下面是最简单、最常用的操作步骤（本地 + 远程仓库都生效）：

---

一、先切换到 main 分支（确保当前在 main）

# 切换到 main 分支
git checkout main

# 拉取最新代码（避免本地不是最新版）
git pull origin main

---

二、打 Tag（两种常用方式）

1. 轻量标签（简单快速，推荐）

# 格式：git tag 标签名
git tag v1.0.0

• 标签名建议：v1.0、v2.1、backup_20250520 这种见名知意的名字。

2. 带备注的标签（更规范，适合正式版本）

# -a 创建标签，-m 写备注
git tag -a v1.0.0 -m "正式发布v1.0.0版本 | 备份main分支"

---

三、把 Tag 推送到远程仓库（必须做！否则只有本地有）

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

# 一次性推送所有本地标签（可选）
git push origin --tags

---

四、查看所有 Tag（验证是否成功）

git tag

执行后会列出你打过的所有标签。

---

五、后期一键恢复到这个版本

以后想回到打 Tag 时的代码，直接执行：

# 切换到标签对应的版本
git checkout v1.0.0

如果想基于这个 Tag 新建分支继续开发

git checkout -b 新分支名 v1.0.0

例如：

git checkout -b rollback_v1 v1.0.0

---

六、删除标签（不需要时用）

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

# 删除远程标签
git push origin :refs/tags/v1.0.0

---

极简总结（直接复制用）

git checkout main
git pull
git tag v1.0.0
git push origin v1.0.0

总结

1. Tag 是永久版本快照，不会随代码提交变化，完美用于备份/回滚。
2. 必须执行 git push 才能把标签同步到远程仓库（GitHub/GitLab/Gitee）。
3. 恢复版本：git checkout 标签名。