Git系列之git tag和ReleaseMilestone

以下是关于 Git Tag、Release 和 Milestone 的深度融合内容，并补充了关于 Git Tag 的所有命令、详细解释和指令实例，条理清晰，结合实际使用场景和案例。

1. Git Tag

1.1 定义

• Tag 是 Git 中用于标记特定提交（commit）的引用，通常用于标记版本发布点（如 v1.0.0）。

• 可以是轻量标签（lightweight tag）或附注标签（annotated tag）。

1.2 使用场景

• 标记版本发布点。

• 查看历史版本。

• 基于标签修复 Bug。

1.3 所有相关命令及详细解释

1.3.1 创建 Tag

• 轻量标签：

git tag <tag-name>

◦ 轻量标签只是一个指向特定提交的引用，不包含额外信息。

◦ 适用于临时标记或本地使用。

◦ 示例：

git tag v1.0.0

• 附注标签：

git tag -a <tag-name> -m "Tag message"

◦ 附注标签是一个完整的对象，包含标签名称、标签信息、签名和时间戳。

◦ 适用于正式版本发布。

◦ 示例：

git tag -a v1.0.0 -m "Release version 1.0.0"

• 对历史提交打 Tag：

git tag -a <tag-name> <commit-hash> -m "Tag message"

◦ 对历史提交打标签，适用于标记过去的提交。

◦ 示例：

git tag -a v1.0.0 abc1234 -m "Release version 1.0.0"

1.3.2 查看 Tag

• 列出所有 Tag：

git tag

◦ 列出所有本地标签。

◦ 示例：

git tag

• 查看 Tag 详细信息：

git show <tag-name>

◦ 查看标签的详细信息，包括标签信息和对应的提交内容。

◦ 示例：

git show v1.0.0

1.3.3 推送 Tag

• 推送单个 Tag：

git push origin <tag-name>

◦ 将指定标签推送到远程仓库。

◦ 示例：

git push origin v1.0.0

• 推送所有 Tag：

git push origin --tags

◦ 将所有本地标签推送到远程仓库。

◦ 示例：

git push origin --tags

1.3.4 删除 Tag

• 删除本地 Tag：

git tag -d <tag-name>

◦ 删除本地标签。

◦ 示例：

git tag -d v1.0.0

• 删除远程 Tag：

git push origin --delete <tag-name>

◦ 删除远程仓库中的标签。

◦ 示例：

git push origin --delete v1.0.0

1.3.5 检出 Tag

• 切换到标签对应的提交：

git checkout <tag-name>

◦ 切换到标签对应的提交。

◦ 注意：标签是一个不可变的快照，检出标签后会进入“分离头指针”状态。

◦ 示例：

git checkout v1.0.0

1.3.6 基于 Tag 创建分支

• 在标签基础上创建新分支：

git checkout -b <branch-name> <tag-name>

◦ 基于标签创建一个新的分支，方便在标签基础上继续开发。

◦ 示例：

git checkout -b hotfix-v1.0.0 v1.0.0

1.3.7 重命名 Tag

• 重命名标签：
Git 不支持直接重命名标签，可以通过以下步骤实现：

1. 删除旧标签：

git tag -d <old-tag-name>

2. 创建新标签：

git tag -a <new-tag-name> <commit-hash> -m "New tag message"

3. 推送新标签：

git push origin <new-tag-name>

◦ 示例：

git tag -d v1.0.0
git tag -a v1.0.1 abc1234 -m "Renamed tag to v1.0.1"
git push origin v1.0.1

2. GitHub/GitLab Release

2.1 定义

• Release 是基于 Git tag 的高级功能，通常用于发布软件的正式版本。

• 除了包含 tag 信息外，还可以附加发布说明、二进制文件（如编译后的可执行文件）等。

2.2 使用场景

• 发布正式版本。

• 提供详细的发布说明。

• 分发二进制文件（如安装包、压缩包）。

2.3 创建 Release

在 GitHub 上创建 Release

1. 进入仓库的 Releases 页面。

2. 点击 Draft a new release。

3. 选择或创建一个 tag（如 v1.0.0）。

4. 填写标题和发布说明。

5. 上传二进制文件（如 .zip 或 .exe）。

6. 点击 Publish release。

使用 Git 命令行创建 Release

通过 GitHub API 创建 Release：

curl -X POST -H "Authorization: token YOUR_GITHUB_TOKEN" \
-d '{"tag_name": "v1.0.0", "name": "Release v1.0.0", "body": "Initial release", "draft": false, "prerelease": false}' \
https://api.github.com/repos/OWNER/REPO/releases

3. Milestone

3.1 定义

• Milestone 是项目管理中的功能，用于跟踪一组相关任务（issues 或 pull requests）的进度。

• 通常与项目的阶段性目标或版本发布相关联。

3.2 使用场景

• 规划版本发布的目标。

• 跟踪任务的完成进度。

• 管理阶段性目标。

3.3 创建 Milestone

在 GitHub 上创建 Milestone

1. 进入仓库的 Issues 页面。

2. 点击 Milestones。

3. 点击 New milestone。

4. 填写名称（如 v1.0.0 Release）、描述和截止日期。

5. 点击 Create milestone。

将 Issue 或 Pull Request 关联到 Milestone

• 在 Issue 或 PR 页面，选择 Milestone 并关联到目标 Milestone。

4. Tag、Release 和 Milestone 的区别

功能   Tag   Release   Milestone
定义   标记特定提交的引用   基于 Tag 的正式发布，包含附加信息   用于跟踪一组任务的阶段性目标
内容   提交的引用（轻量或附注）   Tag 信息、发布说明、二进制文件   任务列表、进度、截止日期
用途   标记版本点、查看历史版本   发布正式版本、分发二进制文件   规划版本目标、跟踪任务进度
关联性   与提交直接关联   基于 Tag，可能关联 Milestone   与 Issue 或 PR 关联
工具支持   Git 原生支持   GitHub/GitLab 提供支持   GitHub/GitLab 提供支持