在版本发布管理中，分支适合用于日常开发和并行任务，而 Tag 更适合标记确定的发布版本，确保代码快照不可变。

命令速用版

日常操作中，区分和使用两者的命令如下：

git branch <branch-name>            # 创建分支
git checkout -b <branch-name>       # 创建并切换分支
git tag v1.0.0                      # 创建轻量标签
git tag -a v1.0.0 -m "release"      # 创建附注标签（推荐）
git push origin `--tags`              # 推送标签到远程
git push origin `--delete` tag v1.0.0 # 删除远程标签

核心区别：轻量标签与附注标签

分支本质上是一个可移动的指针，指向一系列提交的最新位置。Tag 分为两种：

• 轻量标签（Lightweight）：直接指向提交对象，不含额外信息，类似临时书签。
• 附注标签（Annotated）：包含打标签者信息、日期和注释，存储为独立对象，建议发布版本使用 git tag -a 创建。

分步处理

在版本发布流程中，建议按以下步骤操作：

1. 开发阶段：在功能分支（如 feature/xxx）上进行开发。
2. 集成阶段：合并到主分支，确保代码稳定。
3. 发布阶段：遵循语义化版本规范（SemVer），如 v1.0.0，执行 git tag -a 创建标签。
4. 自动化：在 CI/CD 流水线中配置自动打 Tag 策略，避免人工遗漏。
5. 推送阶段：使用 git push origin `--tags` 同步标签。

怎么验证是否生效

可以通过以下命令确认分支和 Tag 的状态：

git branch          # 列出所有分支
git tag             # 列出所有标签
git show v1.0.0     # 查看标签对应的提交详情
git status          # 检查是否处于 detached HEAD 状态

检查远程仓库界面，确认 Tag 已存在且指向正确的提交哈希值。若 git status 显示 "HEAD detached at"，说明当前处于标签检出状态。

常见坑

• Detached HEAD 状态：执行 git checkout <tag> 后会进入分离头指针状态，此时提交代码不会关联到任何分支，重启后可能丢失。如需修改，请新建分支 git checkout -b fix-branch。
• 发布后忘记打 Tag：仅依赖分支发布容易因分支后续提交导致版本代码不一致。
• 标签命名不规范：标签应使用语义化版本号（如 v1.0.0），避免使用中文或特殊字符。
• 误删标签：标签一旦创建不应随意修改，删除后需通知团队更新本地仓库 git fetch `--prune`。

参考来源

• Git 官方文档 - 标签
• 语义化版本规范 2.0.0