Git清理本地已经不存在的远程分支-git-PHP中文网

git remote prune origin 不会删除本地分支，因为它只清理 refs/remotes/origin/ 下的远程跟踪分支（如 origin/feat/login），而本地分支（如 feat/login）存于 refs/heads/，属独立引用，需用 git branch -d 手动安全删除。

git清理本地已经不存在的远程分支

git remote prune 为什么没删掉本地分支

执行 git remote prune origin 只会清理本地的「远程跟踪分支」（比如 origin/feat/login），但不会动你本地创建并 checkout 过的分支（比如 feat/login）。这是最常被误解的一点——你以为它在“同步分支列表”，其实它只管 remote tracking refs。

常见错误现象：git branch -a 仍能看到已合并且远程早已删除的 feat/login 分支，而 git remote prune 执行后毫无变化。

本地分支是独立引用，和远程跟踪分支是两套 ref：一个在 refs/heads/，一个在 refs/remotes/origin/
git remote prune 只影响后者，且默认不带 --dry-run，建议先加该参数预览
如果远程分支被 force-push 覆盖过，prune 也可能不生效——它只删“不存在于远程”的跟踪分支，不校验 commit 一致性

如何安全批量删除已 merged 且远程不存在的本地分支

不能靠猜，得用 Git 原生命令组合验证两个条件：① 本地分支已合并到主干（如 main）；② 对应远程分支在 origin 上查不到。

实操推荐这条命令（bash/zsh）：

git branch --merged main | grep -v "^[ *]\|main\|master$" | while read branch; do \
  remote_branch="origin/${branch#remotes/origin/}"; \
  if ! git ls-remote --heads origin "${branch}" > /dev/null; then \
    echo "Deleting local branch: $branch"; \
    git branch -d "$branch"; \
  fi; \
done

说明：

GitHub Actions Secret Exposure Audit

审计 GitHub Actions 工作流文件的密钥泄露风险，例如 pull_request_target 密钥使用、密钥回显命令及未固定版本的 Action 密钥传递。

下载

git branch --merged main 确保只处理已合入主线的安全分支
grep -v 排除当前分支、main、master 等保护分支
git ls-remote --heads origin "${branch}" 是比 git show-ref 更准的远程存在性判断——它直连远程仓库，不依赖本地 fetch 状态
用 git branch -d（非 -D）防止误删未合并分支

fetch --prune 和 remote prune 的区别与陷阱

git fetch --prune origin 看似更“主动”，但它等价于先 fetch 再 prune，依然只清理 refs/remotes/origin/*，不碰 refs/heads/*。很多人以为加了 --prune 就一劳永逸，结果本地垃圾分支越积越多。

配置 git config --global fetch.prune true 后，每次 git fetch 都自动 prune 远程跟踪分支，但同样不影响本地分支
如果远程仓库用了镜像或权限分片（如 GitHub Enterprise + 自建 proxy），ls-remote 可能超时或返回空，导致误判分支“不存在”
某些 CI 环境禁用 ls-remote（出于安全策略），此时需改用 git ls-remote origin | grep "refs/heads/${branch}$" 辅助判断

别忽略 upstream 设置失效的问题

当你删掉一个本地分支后又重建同名分支，Git 不会自动恢复它的 upstream 关系。下次 git push 会报 fatal: The current branch X has no upstream branch，必须手动 git branch --set-upstream-to=origin/X X。

更隐蔽的问题是：git status 显示 “Your branch is up to date with 'origin/X'”，但实际这个 upstream 指向的是旧的、已删除的远程分支引用——因为 git branch -d 不清理 branch.X.merge 配置项。

检查是否残留：运行 git config --get branch.X.merge 和 git config --get branch.X.remote
清理方式：git config --unset branch.X.merge && git config --unset branch.X.remote
自动化脚本里建议在 git branch -d 后加一行 git config --unset-all branch."$branch".* 防止配置漂移

上游关系不是“绑定”而是“快照”，删分支不等于删配置，这点容易被跳过。