git标签管理需严格区分轻量级与带注解标签：发布版本必须用git tag -a并附消息，ci/cd依赖其元数据；推送应优先单个标签而非--tags，避免污染远程；删除远程标签后须同步清理本地引用；标签命名须统一遵循语义化版本规范。
Git打标签不是“加个标记”就完事，关键在选对类型、推对地方、删得干净——否则远程仓库里会残留废弃标签，CI/CD 流水线可能误用旧版本。
轻量级标签 vs 带注解的标签：别默认用 git tag v1.0
轻量级标签只是个指向提交的指针，没作者、没时间、没消息，git show v1.0 什么也看不到。CI 脚本或审计工具依赖标签元数据时会直接失败。
- 发布版本必须用带注解的标签：
git tag -a v1.0.0 -m "release candidate for prod" - 临时调试可用轻量级标签，但别推到远程：
git tag debug-20260415 - 带注解标签会生成独立对象，能被 GPG 签名（
git tag -s v1.0.0 -m "signed release"），适合合规场景
推送标签到远程：git push origin --tags 有坑
这个命令会把本地所有标签一股脑推上去，包括你忘了删的测试标签、拼错的 v1.o.0、甚至别人分支上遗留的 tmp-wip。一旦推上去，就得手动清理。
- 生产环境只推单个标签：
git push origin v1.0.0 - 确认要推哪些标签：
git tag --sort=-v:refname | head -5（按语义化版本倒序看最新5个） - 如果真要用
--tags，先过滤：git tag -l "v[0-9]*" | xargs -I{} git push origin {}
删除远程标签后，本地仍显示：因为 git fetch 不自动同步标签状态
执行 git push origin --delete v0.9 后，git tag 还能看到它——这不是 bug，是设计：Git 不把远程标签删除动作同步到本地引用。
- 删完远程，立刻删本地：
git tag -d v0.9 - 或者批量清理已不存在的远程标签：
git tag -l | xargs -n 1 git ls-remote --tags origin | grep -v '\^{}$' | cut -d' ' -f2 | grep -v '\^{}$' | xargs -r git tag -d（较重，建议脚本封装） - IDE（如 IntelliJ）里右键删标签只删本地，必须额外点“Push Tags”或手动命令才生效
检出标签后修改代码，不会影响原标签指向的提交
git checkout v1.0.0 进入的是分离头指针（detached HEAD）状态，此时改代码、提交，新提交跟 v1.0.0 完全无关——标签永远钉死在它创建时的那个 commit hash 上。
- 想基于旧版本修 bug？建新分支：
git checkout -b hotfix/v1.0.1 v1.0.0 - 切回标签后执行
git status显示 “HEAD detached at v1.0.0”，这是正常提示，不是错误 - 误操作提交后想回到标签原始状态：
git reset --hard v1.0.0（前提是没推）
最常被忽略的一点：团队协作中，标签命名必须统一规范（比如强制 vX.Y.Z），否则 git tag -l "v1.*" 会漏掉 v1.0 或匹配到 v10.0；正则匹配和排序行为在不同 Git 版本间也有差异，别依赖模糊匹配做自动化发布。
