git fetch --prune 不清理远程标签引用，因为它默认仅修剪 refs/remotes/origin/ 分支引用，不处理 refs/tags/ 标签引用；git 将 tag 视为一次性快照而非跟踪式引用，需用 git fetch --prune --tags 或 git fetch -p --tags 显式启用标签清理。
git fetch --prune 为什么不能清理远程标签引用
因为 git fetch --prune 默认只修剪远程分支（refs/remotes/origin/*），不碰远程标签（refs/tags/*）。即使远程仓库已删掉某个 tag，本地 refs/tags/v1.2.3 依然存在，且不会被自动删除——Git 把 tag 视为轻量级快照，不是跟踪式引用。
如何安全删除本地已失效的远程标签
直接删 refs/tags/xxx 不安全，容易误删本地打的 tag。正确做法是比对远程真实 tag 列表，只删“本地有但远程没有”的那些：
- 先运行
git ls-remote --tags origin获取远程当前所有 tag（含 ^{} 后缀的附注 tag 对象） - 再用
git tag -l列出本地所有 tag - 用脚本过滤出仅存在于本地的 tag，逐个执行
git tag -d xxx
一行命令可完成（bash/zsh）：
comm -13 <h3>为什么不能用 git remote prune origin</h3> <p><code>git remote prune origin</code> 等价于 <code>git fetch --prune</code>，它只作用于 <code>refs/remotes/origin/*</code>，对 <code>refs/tags/*</code> 完全无影响。这是 Git 的设计逻辑：tag 是一次性发布标记，不是持续同步对象。即便你配置了 <code>fetch = +refs/tags/*:refs/tags/*</code>，也不会触发自动 prune。</p> <h3>CI/CD 或自动化脚本里要注意什么</h3> <p>在构建环境中频繁 clone/fetch 时，旧 tag 积累会导致 <code>git tag -l</code> 输出膨胀，影响后续 tag 相关逻辑（比如语义化版本解析）。必须显式清理：</p>
- 避免用
git fetch --tags—— 它会拉取所有历史 tag，包括已被删除的（如果远程没 prune 过） - 改用
git fetch origin --tags --no-tags配合手动同步（不推荐）；更稳妥的是 fetch 后立即跑上述comm清理命令 - 注意
git tag -d不影响已推送到远程的 tag，但会删掉本地对应的 ref 和（如果是附注 tag）签名对象
远程 tag 删除后，本地残留引用本身不破坏工作流，但会干扰基于 tag 的自动化判断——比如误认为 v2.0.0 存在而实际已撤回。这事容易被忽略，直到某次发布脚本读到错误 tag 才暴露。
