git fetch --prune 仅清理远程跟踪分支（如 origin/feature/foo），不删除本地分支（如 feature/foo）；因 git 默认惰性同步，需手动执行 git branch -d 配合 git branch -vv 检查 gone 状态并确认合并后方可安全清理。
git fetch --prune 为什么不能自动清理本地分支引用
远程分支被删除后，git branch -r 仍显示它，是因为 Git 默认只更新远程跟踪引用（remote-tracking refs），但不会主动删除已不存在的远程分支对应的本地记录。这属于“惰性同步”机制——git fetch 默认只增加/更新，不删。
真正起作用的是 --prune（或简写 -p），但它只影响远程跟踪分支（如 origin/feature/foo），**不会删除你本地的普通分支（如 feature/foo）**。这点常被误解。
-
git fetch --prune origin：清理origin/xxx这类远程跟踪分支 - 它不会动
git branch列出的本地分支，哪怕那个本地分支曾基于已删的origin/xxx - 如果你之前执行过
git checkout -b feature/foo origin/feature/foo，现在origin/feature/foo被删了，feature/foo分支依然存在，且变成“游离”状态（无对应远程）
如何安全识别并删除已失效的本地分支
没有一键命令能自动删掉“曾经跟踪、但远程已不存在”的本地分支，必须分两步：先找出哪些本地分支还存有无效的 upstream 设置，再决定是否删。
检查所有本地分支及其上游配置：
git for-each-ref --format='%(refname:short) %(upstream:short) %(upstream)' refs/heads/
输出类似：
main origin/main refs/remotes/origin/main feature/foo origin/feature/foo refs/remotes/origin/feature/foo legacy-branch
注意第三行：legacy-branch 没有 upstream 输出，说明它没设追踪；第二行虽有 origin/feature/foo，但如果远程已删，下一步会报错。
- 用
git rev-parse --verify origin/feature/foo 2>/dev/null测试该远程跟踪引用是否存在（需先git fetch --prune） - 更实用的是批量检测：运行
git branch -vv | grep ': gone]'—— Git 在git status或git branch -vv中对失效 upstream 显示gone] - 确认后删分支：用
git branch -d branch-name（安全删除，拒绝删未合并的）或git branch -D（强制）
自动化清理脚本的关键判断点
很多人写一键清理脚本，结果误删未合并分支。核心在于：**不能只看 upstream 是否 gone，还要看本地分支是否已合并到当前主干（如 main 或 develop）**。
使用 `gh` CLI 与 GitHub 交互。通过`gh issue`、`gh pr`、`gh run` 和 `gh api` 管理 issue、PR、CI 运行以及高级查询。
一个较稳妥的检查逻辑是：
- 遍历
git branch --format='%(refname:short) %(upstream:short)' - 对每个有 upstream 且含
gone]的分支，运行git merge-base --is-ancestor <branch> main && echo "safe to delete"</branch> - 若返回真，说明该分支已合入
main，可考虑git branch -d - 注意：
git branch -d本身就会做这个 ancestor 检查，所以直接用它比自己判断更可靠
示例（仅列出可安全删除的）：
git branch --format='%(refname:short)' --merged main | grep -v '^main$' | xargs -r git branch -d
但这和“remote gone”无关，只是合并清理。真正匹配“远程已删 + 本地未合并”的场景，必须手动核对。
为什么 git remote prune origin 不等于 git branch -d
git remote prune origin 是 git fetch --prune 的等价写法，只操作 refs/remotes/origin/* 命名空间；而 git branch -d 操作的是 refs/heads/*。两者完全不在同一层。
常见误操作：
- 执行
git remote prune origin后以为“本地分支也清了”，其实只是git branch -r输出变干净了 - 看到
git branch -vv显示[origin/xxx: gone]就直接git branch -D xxx，忽略该分支可能还有未推的提交 - 在多人协作中，别人可能刚删了远程分支但你还没 fetch，此时删本地分支会导致工作丢失
最不容易出错的做法：每次清理前，先 git fetch --prune，再 git branch -vv 扫一眼，对带 gone] 的分支，用 git log origin/main..xxx 确认是否有独占提交，再决定是否删。
