如何删除Git远程仓库中已失效的旧引用及废弃PR关联引用？

嗨，这个问题我太熟悉了！远程仓库里残留的失效PR引用确实挺烦人的，下面一步步教你怎么处理：

首先用git ls-remote命令列出远程仓库的所有引用，重点关注refs/pull/路径下的内容——这是PR相关引用的默认存储位置：

git ls-remote --refs origin

你会看到类似refs/pull/45/head、refs/pull/45/merge的条目，这些就是对应编号45的PR的引用。如果对应的PR已经被合并、关闭很久，那这些就是你要清理的失效引用。

如果只是少数几个失效引用，直接用git push命令删除就行，格式是git push 远程仓库名 :要删除的引用路径：

# 删除某PR的head引用
git push origin :refs/pull/<PR编号>/head
# 删除对应的merge引用（如果有的话）
git push origin :refs/pull/<PR编号>/merge

举个例子，要删除编号123的PR引用，就运行：

git push origin :refs/pull/123/head :refs/pull/123/merge

这里的冒号前面是空的，意思是把远程仓库里的这个引用“替换”成空，也就是删除它。

如果失效引用太多，手动删太麻烦，可以用脚本批量处理：

通用批量删除（谨慎使用！） #

如果你确认所有PR都已经处理完毕（没有活跃中的PR），可以直接批量删除所有refs/pull/下的引用：

# 先列出所有PR引用，确认无误后再执行删除
git ls-remote origin refs/pull/*

# 批量删除
for ref in $(git ls-remote origin refs/pull/* | cut -f2); do
  git push origin :$ref
done

针对GitHub的精准批量删除（推荐） #

如果你的仓库在GitHub上，建议用GitHub CLI（gh）先筛选出已合并/关闭的PR，再批量删除对应的引用，避免误删活跃PR：

# 先安装GitHub CLI，然后登录：gh auth login

# 批量删除已合并的PR引用
for pr in $(gh pr list --state merged --json number --jq '.[].number'); do
  git push origin :refs/pull/$pr/head :refs/pull/$pr/merge
done

# 如果要删除已关闭但未合并的PR引用，把--state改成closed
for pr in $(gh pr list --state closed --json number --jq '.[].number'); do
  git push origin :refs/pull/$pr/head :refs/pull/$pr/merge
done

很多Git托管平台都有自动清理的功能，不用每次手动删：

• GitHub：进入仓库的「Settings」→「Pull Requests」，找到「Automatically delete head branches」选项并开启，这样PR合并或关闭时，会自动删除对应的head分支和PR引用。
• GitLab：在仓库设置的「Repository」→「Merge requests」里，开启「Delete source branch when merge request is accepted」。
• 自建Git服务器：可以配置Git钩子（比如post-merge或自定义PR关闭钩子），实现自动清理失效引用。

注意事项 #

• 操作前建议用--dry-run参数模拟删除，确认命令没问题再执行：git push --dry-run origin :refs/pull/123/head
• 确保你有远程仓库的写入/删除权限，不然会提示权限不足。
• 如果是团队协作，提前和队友打个招呼，避免影响他们的本地操作。

内容的提问来源于stack exchange，提问作者ndrone