Git 中的标签和发布是如何工作的？

Question

Git 中的标签和发布是如何工作的？

Accepted Answer

**标签**将历史中的特定点标记为重要点 — 通常是 **发布**（版本，如 v1.0.0）。与分支不同，标签是固定的指针，不会移动，用于标记和引用发布版本。它们对版本控制和发布管理至关重要。

## 创建标签

```bash
# annotated tag (recommended for releases — has metadata: tagger, date, message)
git tag -a v1.0.0 -m "Release version 1.0.0"

# lightweight tag (just a pointer, no metadata)
git tag v1.0.0

# tag a specific past commit
git tag -a v1.0.0 <commit> -m "..."
```

**带注释的标签**（推荐用于发布）存储元数据（标签者、日期、消息）；**轻量标签**只是指向提交的名称。

## 使用标签

```bash
git tag                        # list tags
git show v1.0.0                # show a tag and its commit
git checkout v1.0.0            # check out the code at a tag (detached HEAD)

# tags are NOT pushed by default — push them explicitly:
git push origin v1.0.0         # push a specific tag
git push origin --tags         # push all tags
```

重要：**标签不会自动随 `git push` 推送** — 你需要显式推送它们。

## 标签与分支

```text
BRANCH → a MOVABLE pointer that advances as you commit (ongoing development)
TAG    → a FIXED pointer to a specific commit (a permanent label — doesn't move)
→ Use tags to permanently mark releases/milestones; branches for ongoing work.
```

## 语义版本控制和发布

```text
SEMANTIC VERSIONING (SemVer): MAJOR.MINOR.PATCH (e.g. v2.3.1)
  MAJOR → breaking changes | MINOR → new features (compatible) | PATCH → bug fixes
→ Tags label these versions. Platforms (GitHub) build "Releases" from tags
  (with release notes, built artifacts) for distribution.
```

## 为什么这很重要

理解标签和发布对于 **版本控制和发布管理** 很有价值，因此是处理已发布软件的有用实践知识。**标签**标记历史中的重要点 — 通常是 **发布版本**（如 v1.0.0） — 提供对特定提交的固定、永久引用，这对于跟踪和引用每个发布包含的代码至关重要。

理解 **带注释的标签**（推荐用于发布，存储标签者、日期和消息等元数据）和轻量标签之间的区别是正确进行发布标签的实践知识。

知道如何创建、列出和检出标签，特别是重要的是 **标签不会自动推送**（需要显式的 `git push origin --tags` 或推送特定标签 — 这是一个常见陷阱，人们创建标签但忘记推送它们），这对于正确管理发布标签是必要的。

理解 **标签与分支**（标签是指向特定提交的固定指针 — 不会移动的永久标签 — 而分支是随开发推进的可移动指针）的区别明确了它们的不同作用：标签用于永久标记发布/里程碑，分支用于正在进行的工作。

理解与 **语义版本控制**（MAJOR.MINOR.PATCH 约定用于传达变更的性质）的联系，以及平台如何从标签构建 **发布**（包含发布说明和用于分发的构件），反映了标签如何融入实际的发布管理。

由于发布和版本控制软件是常见需求，而标签是用于标记和引用发布版本的 Git 机制（对发布管理至关重要，并与平台的发布功能集成），理解标签和发布 — 带注释的与轻量标签、推送它们、标签与分支、以及它们在版本控制/发布中的作用 — 是管理已发布软件的有价值、切实相关的 Git 知识，是与版本控制约定和发布流程相关联的专业开发的有用方面。