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 提供支持
5. 综合使用场景
场景：发布 v1.0.0 版本
1. 规划目标：
• 创建 Milestone v1.0.0 Release，关联相关 Issues 和 PRs。
• 设置截止日期，跟踪任务完成进度。
2. 开发与测试：
• 完成所有关联的任务，确保代码通过测试。
3. 打 Tag：
• 在最终提交上打 Tag：
git tag -a v1.0.0 -m "Release version 1.0.0"
git push origin v1.0.0
4. 创建 Release：
• 在 GitHub 上基于 v1.0.0 创建 Release。
• 填写发布说明，上传二进制文件（如安装包）。
5. 完成 Milestone：
• 关闭所有关联的 Issues 和 PRs。
• 标记 Milestone 为完成。
6. 总结
• Tag：用于标记提交，是版本管理的基础。
• Release：基于 Tag 的正式发布，包含附加信息和二进制文件。
• Milestone：用于规划版本目标和跟踪任务进度。
在实际项目中，这三者通常结合使用：
• 通过 Milestone 规划版本目标。
• 通过 Tag 标记版本点。
• 通过 Release 发布正式版本。
通过合理使用这些功能，可以更好地管理项目的版本历史和发布流程。
参考文章：
Git系列详细介绍和操作
