Git 打标签完全指南:从本地创建到远端推送

在软件开发中,Git标签(Tag)是为发布版本、标记里程碑量身定制的"快照锚点",它能永久记录项目历史中的关键节点。然而,仅创建本地标签往往不够,如何将其高效地推送到远程仓库以实现团队共享,是许多开发者会遇到的实际问题。


一、标签的两种"形态"

类型 本质 适合场景 命令示例
轻量标签 仅是一个指向提交的引用 临时/本地标记 git tag v1.0.0
附注标签 独立对象,含作者/日期/GPG 签名 正式发版、开源发布 git tag -a v1.0.0 -m "Release v1.0.0"

90% 的场景请用 附注标签,因为它携带的元数据对版本追溯至关重要。


二、本地创建与查看

1. 打附注标签(推荐)

bash 复制代码
# 给当前 HEAD 打标签
git tag -a v1.0.0 -m "Release version 1.0.0"

# 给指定提交打标签
git tag -a v1.0.0 9fbc3d2 -m "Release v1.0.0"

2. 查看标签

bash 复制代码
git tag              # 简洁列表
git show v1.0.0      # 查看标签详情及对应提交

输出示例:

sql 复制代码
tag v1.0.0
Tagger: YourName <you@example.com>
Date:   Sun Sep 14 00:00:00 2025 +0800

Release version 1.0.0

三、推送标签到远端

默认 git push 不会 传标签!必须显式操作。

场景 命令
推送单个标签 git push origin v1.0.0
一次性推送所有标签 git push origin --tags
推送时包含新分支及标签 git push origin --follow-tags

示例:

bash 复制代码
# 推送 v1.0.0
git push origin v1.0.0

# CI 自动发版常用:只推送本次打的标签
git push origin --follow-tags

四、删除标签(本地 & 远端)

位置 命令
本地 git tag -d v1.0.0
远端 git push origin --delete v1.0.0git push origin :refs/tags/v1.0.0

一条龙删除:

bash 复制代码
git tag -d v1.0.0
git push origin --delete v1.0.0

五、高频问题速查

1、推送时报 "error: src refspec v1.0.0 matches more than one"

本地有同名分支,先删除分支或显式指定 refs/tags/v1.0.0

2、CI 没触发 Release 流程

确认是否推了 附注标签 且 CI 监听的是 tag 事件。

3、如何补打旧版本标签?

bash 复制代码
git log --oneline       # 找到历史提交
git tag -a v0.9.0 5f3d2e1 -m "Retroactively tag v0.9.0"
git push origin v0.9.0

六、一张图总结(保存即可)

perl 复制代码
本地创建 → 查看 → 推送 →(可选)删除
   │         │       │         │
   ▼         ▼       ▼         ▼
git tag -a  git tag  git push  git tag -d
v1.0.0      v1.0.0   origin    v1.0.0
                    v1.0.0    git push
                              --delete

相关推荐
YiHanXii18 小时前
this 输出题
前端·javascript·1024程序员节
楊无好18 小时前
React中ref
前端·react.js
程琬清君18 小时前
vue3 confirm倒计时
前端·1024程序员节
歪歪10018 小时前
在C#中详细介绍一下Visual Studio中如何使用数据可视化工具
开发语言·前端·c#·visual studio code·visual studio·1024程序员节
唔6619 小时前
flutter实现web端实现效果
前端·flutter
csj5019 小时前
前端基础之《React(2)—webpack简介-使用Babel》
前端·react
刘新明198920 小时前
算法还原案例4-OLLVM_MD5
开发语言·前端·javascript·1024程序员节
言德斐20 小时前
Python Web框架深度对比:Django vs Flask vs FastAPI(含优缺点与选型策略)
前端·python·django
疯狂的沙粒21 小时前
前端开发【工具函数】基于dayjs 封装的DateUtils工具函数,可以直接拿着使用
前端·javascript·vue.js·1024程序员节
jingling55521 小时前
CSS进阶 | 不用一行JS!用纯CSS打造会动的现代化单页应用(3D翻转卡片)
前端·javascript·css