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

本文主要讲解关于Git打标签从本地创建到远端推送的详细流程相关内容，由优网导航（www.uonce.com）提供，欢迎关注收藏本站！

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

一、标签的两种“形态”

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

程序员导航

优网导航旗下整合全网优质开发资源，一站式IT编程学习与工具大全网站

立即访问

二、本地创建与查看

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

AI 工具导航

优网导航旗下AI工具导航，精选全球千款优质 AI 工具集

立即访问

三、推送标签到远端

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

示例：

# 推送 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

五、高频问题速查

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打标签流程内容请搜索优网导航以前的文章或继续浏览下面的相关文章希望大家以后多多支持优网导航！

您可能感兴趣的文章:

• IDEA升级后Git拉取和推送的标签消失的解决方法
• Git基础学习之tag标签操作详解
• Git基础学习之标签tag的使用详解
• Git中tag标签的使用教程
• Git 标签使用详解