在 Git 版本控制中，标签（tag）用于为特定的提交打上标记，常用于标识版本发布点。本文围绕“Git 标签管理”这一主题，通过典型场景演示如何创建、查看与删除标签，并指出常见误区。
场景一：创建标签——轻量标签与附注标签
假设你刚完成 v1.0 版本的开发，需要打上标签。Git 提供两种标签：轻量标签（lightweight）和附注标签（annotated）。轻量标签只是一个指向提交的引用，不包含额外信息；附注标签则存储打标签者、日期、消息等元数据，推荐用于发布版本。
创建轻量标签：git tag v1.0。创建附注标签：git tag -a v1.0 -m "Release version 1.0"。如果需要对历史提交打标签，在命令末尾加上提交哈希即可，例如 git tag -a v0.9 9fceb02。
常见误区：混淆两种标签，或在打标签时忘记添加 -a 和 -m，导致标签缺少必要信息。对于发布版本，应使用附注标签。
场景二：查看标签——列表与详情
需要查看所有标签时，运行 git tag 会按字母顺序列出。若要搜索特定模式，例如 git tag -l "v1.*"。查看某个标签的详细信息，使用 git show v1.0，它会显示标签的提交信息、打标签者等。如果只想查看标签指向的提交，用 git rev-list -n 1 v1.0 或 git rev-parse v1.0。
常见误区：误以为 git tag 会显示标签详情，实际上它只列出名称。需要详情时务必使用 git show。
场景三：删除标签——本地与远程
当标签打错或不再需要时，可以删除。删除本地标签：git tag -d v1.0。如果标签已经推送到远程仓库，需要删除远程标签：git push origin --delete v1.0，或者使用 git push origin :refs/tags/v1.0（但前者更直观）。删除后，其他协作者需要更新远程引用：git fetch --prune --prune-tags。
常见误区：只删除本地标签而忘记删除远程标签，导致远程残留。另外，删除标签前应确认没有分支依赖它，但 Git 标签不是分支，删除不会影响工作区。
场景四：常见错误与解决思路
错误一：fatal: tag 'v1.0' already exists。原因是标签名已存在，可以先删除旧标签或使用新名称。错误二：error: src refspec v1.0 does not match any，通常是因为本地没有该标签，检查拼写或先创建。错误三：推送标签时使用 git push origin v1.0 只推送单个标签，若需推送所有标签用 git push --tags，但注意这也会推送轻量标签。
另一个常见问题是标签与分支混淆。标签指向固定提交，而分支会随开发移动。在发布流程中，标签用于记录版本，分支用于开发。
总结
Git 标签管理是版本控制的重要一环。通过创建附注标签标记发布，使用 git tag 和 git show 查看，删除时注意本地与远程同步。掌握这些方法，能更规范地管理版本。
参考资料
延伸阅读