如何使用Git为特定版本创建标签并管理发布流程？

本文共计862个文字，预计阅读时间需要4分钟。

git tag -a -m 正式发布 v1.0.0 命令用于创建一个带有描述信息的轻量级标签，表示一个正式的发布版本。在CI/CD和包管理器中，这种轻量级标签通常基本无效。

为什么 git tag v1.0.0 打完就“消失”了？

它其实没消失，只是打在了当前 HEAD 上——而你真正想标记的可能是三天前那次合并提交。常见错误现象：运行 git tag v1.0.0 后，git show v1.0.0 显示的是最新调试提交，不是发布 commit。

• 先确认目标提交：git log --oneline -n 15 找到你要标记的 hash（比如 abc1234）
• 精准打标：git tag v1.0.0 abc1234（哪怕你刚 checkout 过那个 commit，也建议显式写 hash）
• 别依赖分支名：git tag v1.0.0 main 看似方便，但若 main 已推进，标签会意外漂移

git tag -a 和 git tag 的实际差别在哪？

差别不是“有没有消息”，而是 Git 对象模型层面的根本不同：轻量标签只是个引用文件，附注标签是独立 commit-like 对象，带签名、时间戳、作者邮箱——CI 流水线（如 GitHub Actions）、npm publish、cargo publish 全部只认后者。