你想了解 Git 中打 Tag（标签）的完整操作，Tag 主要用于标记项目的重要版本节点（比如 v1.0.0、v2.1.1），方便后续回溯和发布，下面我会详细讲解从创建到推送、查询、删除的全套操作。

一、Tag 的两种类型

Git 支持两种 Tag，先明确区别，方便你选择使用：

  1. 轻量标签（Lightweight）：仅记录版本的提交哈希值，无额外信息，相当于一个「只读的提交书签」，适合内部临时标记。
  2. 附注标签（Annotated）：包含完整元信息（标签作者、邮箱、创建时间、标签说明），会被 Git 完整追踪，适合正式发布版本（推荐优先使用）。

二、核心操作步骤

1. 前提准备（可选）

先确保你的本地仓库代码是最新的，且处于需要打标签的提交节点（默认在当前 HEAD 指向的提交上打标签）：

# 拉取远程最新代码（如需）
git pull origin 分支名（如 main/master）

2. 创建 Tag

（1）创建附注标签（推荐，正式版本使用）

命令格式：git tag -a 标签名 -m "标签说明"

# 示例：创建 v1.0.0 正式版本标签，附带说明
git tag -a v1.0.0 -m "第一个正式发布版本，支持核心功能A和B"
  • 选项说明：-a（annotated）表示创建附注标签，-m 后跟标签的说明信息（必填，否则会进入编辑器让你输入）。

  • 补充：如果想给历史提交打标签（不是当前 HEAD），可以在标签名后加上提交哈希值（前6-8位即可）：

    # 示例：给哈希值为 a1b2c3d 的历史提交打标签
git tag -a v0.9.0 -m "内测版本" a1b2c3d
（2）创建轻量标签（内部临时使用）

命令格式：git tag 标签名（无额外选项）

# 示例：创建 v1.0.0-beta 轻量标签（临时测试版）
git tag v1.0.0-beta
  • 该标签仅保存提交哈希，无任何附加信息，创建速度更快，适合内部临时标记，不推荐用于正式发布。

3. 查看 Tag

（1）查看所有 Tag

按创建时间倒序排列（最新的在最前面）：

git tag
# 或带筛选（比如只查看 v1 开头的标签）
git tag -l "v1*"
（2）查看某个 Tag 的详细信息

仅对附注标签有效（轻量标签无额外信息可查）：

# 示例：查看 v1.0.0 标签的详细元信息
git show v1.0.0

输出结果会包含标签作者、创建时间、标签说明、对应的提交内容等。

4. 推送 Tag 到远程仓库

注意：创建的 Tag 默认只保存在本地仓库，不会自动同步到远程，需要手动推送：

（1）推送单个 Tag 到远程
# 示例：推送 v1.0.0 标签到远程 origin 仓库
git push origin v1.0.0
（2）推送所有本地未推送的 Tag 到远程

如果创建了多个标签，想一次性同步到远程：

git push origin --tags

5. 删除 Tag

（1）删除本地 Tag
# 示例：删除本地 v1.0.0 标签
git tag -d v1.0.0
（2）删除远程仓库的 Tag

需要先删除本地 Tag，再推送「删除指令」到远程：

# 步骤1：先删除本地 Tag（如已删除可跳过）
git tag -d v1.0.0

# 步骤2：推送删除指令到远程，删除远程的 v1.0.0 标签
git push origin --delete v1.0.0
# 或等价命令（兼容部分旧版本 Git）
git push origin :refs/tags/v1.0.0

6. 切换到某个 Tag 版本

Tag 标记了特定的提交节点，你可以切换到该版本查看或导出代码（注意：切换后处于「分离头指针」状态，不要直接在该状态下修改和提交代码，如需修改请创建新分支）：

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

补充：如果需要在切换后修改代码（避免分离头指针风险）

# 从 Tag 版本创建一个新分支，然后在新分支上开发
git checkout -b branch-v1.0.0 v1.0.0

总结

  1. Tag 分轻量（临时标记）和附注（正式版本，推荐）两种，创建附注标签需用 git tag -a 标签名 -m "说明"。
  2. 本地 Tag 不会自动同步远程，单个推送用 git push origin 标签名，批量推送用 git push origin --tags。
  3. 删除远程 Tag 需先删本地（git tag -d 标签名），再推送删除指令（git push origin --delete 标签名）。
  4. 切换 Tag 版本后处于分离头指针状态，如需修改代码应基于该 Tag 创建新分支。

版权属于：Joyber

本文链接：https://blog.qqvbc.com/default/1419.html

转载时须注明出处及本声明

标签: none

添加新评论