git tag 不生效主因是未指定目标提交哈希、未推送或混用标签类型；应查 commit hash 后用 git tag -a v1.0.0 -m "release" 打附注标签，再 git push origin v1.0.0 推送。
git tag 命令不生效？先确认是否在正确提交上操作
打标签失败，十有八九是因为 git tag 默认给当前 HEAD 打，而你真正想标记的可能是历史某次发布提交。如果没加参数直接跑 git tag v1.0.0，它不会报错，但标签会落在最新一次 commit 上——哪怕那是个临时调试提交。
- 查清目标提交：用
git log --oneline -n 20找到你要标记的 commit hash（比如a1b2c3d） - 精准打标签：写全命令
git tag v1.0.0 a1b2c3d，别省略 hash - 本地标签默认不推送：
git push不会把 tag 推上去，必须显式执行git push origin v1.0.0或git push origin --tags
轻量标签 vs 附注标签：什么时候该用 git tag -a
轻量标签（git tag v1.0.0）只是个指向 commit 的指针，没元数据；附注标签（git tag -a v1.0.0 -m "release"）会生成独立对象，带作者、时间、签名和消息——CI/CD 工具、包管理器（如 npm、Cargo）通常只信任附注标签。
- 发版必用附注：只要涉及正式发布，一律走
git tag -a - 签名更安全：加
-s用 GPG 签名（git tag -s v1.0.0 -m "signed release"），但需提前配好密钥 - 别混用：同一版本号不能既有轻量又有附注标签，后建的会覆盖前一个，且类型不一致会导致工具解析异常
push 失败提示 error: failed to push some refs to '...' ？检查远程是否已存在同名 tag
Git 不允许覆盖远程 tag，哪怕你本地删了重打，git push --force 也无效。错误信息里常带 ! [rejected] v1.0.0 -> v1.0.0 (already exists)。
- 先删远程：用
git push origin :refs/tags/v1.0.0（注意冒号前有空格） - 再删本地：用
git tag -d v1.0.0，否则下次git push --tags还会试图推旧标签 - 重打+重推：确保本地是新附注标签后，再
git push origin v1.0.0 - CI 场景特别注意：某些流水线会自动拉取所有 tag，旧 tag 残留可能触发重复构建
如何验证 tag 是否真能对应到代码？别只信 git show v1.0.0
git show v1.0.0 只显示标签对象本身（如果是附注标签，就显示签名和消息），看不出它到底指向哪个 commit。真正要确认，得看底层关联。
- 查指向：用
git rev-parse v1.0.0输出 commit hash，再用git show --oneline <hash></hash>看实际代码 - 比对分支：运行
git merge-base v1.0.0 main，如果输出和v1.0.0的 hash 一致，说明它确实在 main 分支可及路径上 - CI 构建时常用陷阱：Docker 构建用
git clone --depth=1会丢掉所有 tag，必须加--tags或改用完整克隆
