Git 和 GitHub 的 **Tag（标签）** 功能是一个非常实用的版本控制工具，主要用于**标记项目中的重要时间点**，例如软件的发布版本（v1.0、v2.0-beta 等）。 ## 一、理解 Git Tag ### Tag 的作用 Git Tag 本质上是给某个特定的 **Commit（提交）** 打上一个**永久性的、易于理解的别名**或**里程碑**。 * **固定版本快照：** 标签一旦创建，它就永远指向那个特定的 Commit，不会像分支（Branch）那样随着新的提交而移动。 * **发布管理：** 最常见的用途是标记正式的发布版本（Release）。例如，当你的代码准备发布 v1.0 版本时，你可以给当时的最后一次 Commit 打上 `v1.0` 的标签。 * **版本追溯：** 方便团队成员和用户随时检出（checkout）或下载某个历史版本的代码。 ### Tag 的种类 Git 主要支持两种类型的标签： | 标签类型 | 特点 | 适用场景 | 创建命令示例 | | :--- | :--- | :--- | :--- | | **轻量级标签 (Lightweight)** | 只是一个指向特定 Commit 的指针，不包含额外信息。 | 临时或私有标记，只作为 Commit 的书签。 | `git tag v1.0-lw` | | **附注标签 (Annotated)** | 作为一个完整的对象存储在 Git 数据库中，包含：标记者姓名、电子邮件、日期、标签消息，并可进行 GPG 签名。 | 推荐用于正式公开发布，因为它包含了所有重要的元数据。 | `git tag -a v1.0 -m "First stable release"` | ## 二、使用标签 ### 标记当前最新 Commit 默认情况下，标签会打在当前分支的最新 Commit 上（HEAD）。 * **轻量级：** ```bash git tag # 示例：git tag v1.0 ``` * **附注标签（推荐）：** ```bash git tag -a -m "标签信息" # 示例：git tag -a v1.0 -m "First official release" ``` ### 标记历史 Commit 你可以通过 Commit ID 来为历史提交打标签。 1. 先用 `git log --pretty=oneline` 找到目标 Commit 的 ID（前几位即可）。 2. 然后使用命令： ```bash git tag -a -m "标签信息" # 示例：git tag -a v0.9 9f0322c -m "Pre-release version" ``` ### 将本地标签推送到远程 (GitHub) 标签在本地创建后，默认**不会**自动推送到远程仓库（如 GitHub）。你必须手动推送。 * **推送单个标签：** ```bash git push # 示例：git push origin v1.0 ``` * **推送所有标签：** ```bash git push --tags # 示例：git push origin --tags ``` ### 删除标签 * **删除本地标签** ```bash git tag -d # 示例：git tag -d v0.9 ``` * **删除远程标签（从 GitHub 删除）** 删除远程标签需要两个步骤：先删除本地标签，再将删除操作推送到远程。 ```bash # 步骤 1: 删除本地标签 (如果本地还有的话) git tag -d # 步骤 2: 推送到远程删除标签 git push :refs/tags/ # 或者使用更简洁的语法 (Git v1.8.5+): git push --delete # 示例：git push origin --delete v0.9 ``` ### 基于标签检出代码（回退到某个版本）你不能像切换分支那样直接 `git checkout `，因为标签是一个固定指针而不是可移动的分支。要回到标签所指向的版本并在此基础上工作，你需要**基于标签创建一个新的分支**： ```bash git checkout -b # 示例：git checkout -b fix-v1.0 v1.0 ``` 这样，你就创建了一个名为 `fix-v1.0` 的新分支，它从 `v1.0` 标签对应的 Commit 开始。 ## 三、GitHub 上的 Tag 功能当你的标签被推送到 GitHub 后，它会在 Web 界面上以 **"Releases"（发行版）** 的形式体现出来，这增强了 Tag 的管理和发布能力： 1. **自动创建 Release:** 当你推送一个附注标签（Annotated Tag）到 GitHub 后，GitHub 会自动将其列在仓库的 **Releases** 页面下。 2. **管理发布内容:** 你可以在 GitHub 的 Release 页面给这个标签（版本）添加**详细的说明**、**发行日志**，甚至可以上传**预编译的二进制文件**（如 `.zip` 或 `.exe`），供用户直接下载。 3. **源代码下载:** GitHub 会自动为每个 Tag 生成对应的源代码压缩包（ZIP/TAR.GZ），方便用户下载特定版本的代码快照。简而言之，**Git Tag** 是底层的工具，而 **GitHub Releases** 是在 Tag 基础上提供的**更高级、更用户友好的发布管理界面**。