必须显式推送空引用删除远程分支，推荐用git push origin --delete <branch-name>；误删风险高，需确认分支已合并、非受保护、无依赖；删后需git remote prune origin清理本地缓存。
git push origin --delete 分支名
远程分支不是本地删了就消失的，必须显式通知远端删除。最直接的方式就是用 git push origin --delete <branch-name>。这个命令本质是把一个空引用推送到远端对应分支，Git 服务端收到后就会清理该分支引用。
常见错误现象：git branch -d branch-name 只删本地，远端还在；或者误写成 git push origin :branch-name（旧语法），虽然也能生效，但可读性差、易打错冒号位置。
- 推荐统一用
--delete，语义明确，Git 2.0+ 全支持 - 分支名里有斜杠（如
feature/login-flow）不用加引号，shell 通常能正确解析 - 如果远端拒绝删除（比如受保护分支），会报错
remote: error: unable to delete <branch>: protected branch，得先去仓库设置里关掉保护
删之前先确认分支是否已被合并
远程分支常被多人协作依赖，贸然删除可能让别人 git pull 失败或丢失提交。不是所有分支都“无用”，得看它是否还有未合入主干的变更。
检查方式很简单：git fetch origin 拉最新引用后，运行 git log origin/main..origin/your-branch。如果没输出，说明该分支所有提交都已出现在 main 中（假设主干是 main）。
- 别只看本地
git merge-base，远程分支状态可能已更新 - 如果项目用
develop当集成分支，就把main换成develop - CI/CD 流水线自动创建的临时分支（如
pr-123）可以跳过检查，但要确认流水线已结束
批量删多个远程分支时的注意事项
一次删十几个分支听起来高效，但风险集中——输错一个名字，可能误删正在开发的分支；网络中断还可能导致部分成功、部分失败，状态难回溯。
批量替换指定目录下所有 Git 仓库的远程地址（remote URL）。 当用户需要将 Git 仓库从一个服务器迁移到另一个服务器时使用。 触发词：git remote 替换、git url 批量修改、git 仓库迁移、更换 git 地址、批量修改 remote url。
安全做法是分批、带预览地执行。例如用 shell 命令先列出将删的分支：git ls-remote --heads origin | grep 'feature/old-' | cut -d'/' -f3-，再逐个核对。
- 避免写
git push origin --delete $(git branch -r | grep 'origin/feature/old')这类管道命令，容易因空格、换行出错 - 如果要用脚本批量删，务必在
git push前加echo预览，确认无误再删 - GitHub/GitLab 等平台删除后不会立刻从 UI 列表消失，缓存可能延迟几分钟
删完远程分支，本地仍显示 remote-tracking 分支
git branch -r 还能看到 origin/xxx，不是删失败了，而是本地的远程引用缓存没更新。Git 不会自动同步远端分支的“消失”事件。
手动清理用 git remote prune origin，它会扫描本地记录中哪些 origin/xxx 在远端已不存在，然后删掉对应引用。
- 也可以加
--dry-run参数先看会删哪些：git remote prune origin --dry-run - 某些 IDE（如 VS Code）的 Git 插件会缓存分支列表，删完需重启或手动刷新
- 如果你常用
git fetch --prune（或配置了fetch.prune=true），下次拉取时就会自动清理，不用单独 prune
真正麻烦的不是命令记不住，而是删分支前没搞清谁还在用、有没有 CI 任务卡在上面、甚至忘了某些部署脚本硬编码了分支名——这些地方不查，删完才发现服务起不来了。
