删远程分支必须用 git push origin --delete，不是 git branch -d；该命令只删本地分支，远程分支需由 git push 发起删除请求，且需注意语法、分支名转义、保护分支限制及后续缓存清理。
删远程分支必须用 git push origin --delete，不是 git branch -d
很多人执行 git branch -d feature/login 后发现远程仓库里分支还在，是因为这个命令只删本地分支，对远程毫无影响。远程分支必须由 git push 发起删除请求。
常见错误现象：命令执行成功但 git branch -r 仍显示该远程分支 —— 这不是删失败，而是本地缓存没更新。
-
git push origin --delete feature/login是当前推荐写法，语义清晰、Git 2.20+ 无警告 -
git push origin :feature/login是旧语法，冒号前多一个空格就变成推送空分支到origin，极易出错 - 分支名含斜杠（如
feature/xxx）不用引号；含空格或星号（如bug fix*）必须用单引号包裹：'bug fix*' - 保护分支（如
main、release/*）通常被远程规则拦截，删之前先运行git ls-remote --heads origin确认是否存在
删本地分支用 git branch -d 还是 git branch -D
-d 是安全删除：Git 会检查该分支是否已完全合并到当前分支（比如 main），未合并则拒绝操作并报错 error: The branch 'xxx' is not fully merged.。
-D 是强制删除：绕过合并检查，直接删掉分支引用。数据不可恢复，除非你本地还有提交 SHA 或 reflog 记录。
- 日常清理建议先试
git branch -d branch-name，失败再判断是否真要丢弃未合并内容 - CI/CD 脚本中常用
-D，避免交互阻塞，但需确保分支状态可控 - 删之前可快速看一眼拓扑：
git log --oneline --graph --all --simplify-by-decoration - 不能在要删的分支上执行删除命令，必须先
git checkout main或其他分支
删完远程分支，git branch -r 还显示它？这是缓存问题
远程分支确实已被删，但你的本地仓库还保留着 remotes/origin/old-branch 这类跟踪引用，属于“过期远程跟踪分支”，不是 bug，是设计如此。
- 手动清理：运行
git remote prune origin（安全，只删已不存在的远程分支记录） - 自动清理（推荐）：设为默认行为
git config --global fetch.prune true，之后每次git fetch或git pull都自动同步 - 别用
git branch -d -r origin/old-branch：这只是删本地记录，不通知远程，也不触发实际删除 - 注意：这个清理只影响你本地，别人仍需各自执行
fetch --prune
批量删废弃分支时，xargs 和 grep 组合要注意什么
团队长期积累的 feature/、fix/ 分支，人工逐条删效率低且易漏。用 shell 命令组合更可靠，但容易踩坑。
- 安全预检：先用
echo做 dry-run，例如：git branch -r | grep 'feature/' | sed 's|origin/||' | xargs -r echo git push origin --delete - 过滤符号引用：加
grep -v '\->'排除origin/HEAD -> origin/main这类指针，否则可能误删 -
xargs -r在输入为空时不报错（Git 2.29+ 支持），老版本建议写成xargs -r || true - 真正麻烦的不是命令执行，而是确认“这个分支真没人用了”——建议交叉核对 CI 构建记录、PR 关闭状态、最近提交时间
最常被忽略的是上游配置残留：即使远程分支已删，如果某个本地分支仍设置 branch.feature/login.merge 指向 refs/heads/feature/login，下次 git pull 就会报 fatal: couldn't find remote ref refs/heads/feature/login。得用 git branch --unset-upstream feature/login 清掉这个配置。
