Git打标签从本地创建到远端推送的详细流程

更新时间：2025年09月15日 08:23:59 作者：洛小豆

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

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

一、标签的两种“形态”

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

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

二、本地创建与查看

1. 打附注标签（推荐）

# 给当前 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. 查看标签

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

输出示例：

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

示例：

# 推送 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.0 或 git push origin :refs/tags/v1.0.0

一条龙删除：

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、如何补打旧版本标签？

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

六、一张图总结（保存即可）

本地创建 → 查看 → 推送 →（可选）删除
   │         │       │         │
   ▼         ▼       ▼         ▼
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

到此这篇关于Git打标签从本地创建到远端推送的详细流程的文章就介绍到这了,更多相关Git打标签流程内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

在VSCode中如何配置Python开发环境
VScode是一个相当优秀的IDE，具备开源、跨平台、模块化、插件丰富、启动时间快、颜值高、可高度定制等等优秀的特质，所以用VScode来编写Python，也是相当的好用的。所以，今天我们就来讲讲，怎么在VScode上配置Python开发环境。
2020-01-01
单点登录之cas集成sonar的配置方法
这篇文章主要介绍了单点登录之cas集成sonar的相关知识，本文通过示例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
2022-03-03
git add -A 和 git add . 的区别详解
这篇文章主要介绍了git add -A 和 git add . 的区别详解，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-07-07
vscode怎么编译运行
本文给大家分享的是vscode怎么一键编译运行的方法,非常的简单实用,有需要的小伙伴可以参考下
2020-02-02
Web 开发常用工具大家自己查找下载
看到了Web通信分析工具这篇文章，除了burpsuite其他我日常都经常使用。于似乎我整理了一下我自己用的其他的WEB开发工具。
2009-06-06
IIS 301重定向与程序代码实现301重定向的差别
过IIS做301重定向确可以实现传递网站的权重，还不会导致流量丢失。
2010-11-11
快速设置IDEA代码风格为Google风格
这篇文章主要介绍了快速设置IDEA代码风格为Google风格,使用Google风格format的图文教程，本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友参考下吧
2020-11-11
vscode更改代码git没有更新问题及解决
这篇文章主要介绍了vscode更改代码git没有更新问题及解决,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2025-05-05
hexo博客开启https的SSL 证书实现过程
这篇文章主要为大家介绍了hexo 博客开启https的SSL证书实现过程详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
2023-10-10
textarea 在IE和FF下换行无法正常显示的解决方法
今天在做项目时用到textarea 用户输入信息后显示不换行在IE下测试成功在FF没反应
2010-07-07