git push origin --delete branch-name 必须有空格，否则 origin--delete 被误认为远程名而报错；推荐使用 --delete 而非旧语法 :branch-name；删前需 fetch 后用 git log 检查是否已合并；删后需 git fetch -p 清理本地远程引用缓存。
git push origin --delete 不能少空格
命令写成 git push origin--delete branch-name 会报错：unknown option --delete，因为 origin--delete 被当成了一个远程名。必须是 git push origin --delete branch-name，中间有空格。
旧语法 git push origin :branch-name 虽然仍可用，但冒号容易漏打或误写成 : 后多空格，且语义模糊；--delete 是 Git 2.0+ 官方推荐写法，可读性强、容错高。
- 分支名含斜杠（如
feature/login-flow）无需引号，shell 默认能解析 - 分支名含空格或特殊字符（极少见）才需单引号包裹：
git push origin --delete 'bug fix' - 别在脚本里直接拼接变量而不加引号，比如
git push origin --delete $branch遇到空格就崩
删之前必须确认分支已合并
远程分支不是“没人用就该删”，关键是看它是否还有未合入主干的提交。只运行 git merge-base origin/main origin/your-branch 不可靠——本地缓存可能过期。
正确做法是先同步远端最新状态：git fetch origin，再检查：
- 主干是
main：运行git log origin/main..origin/your-branch，无输出才表示已全量合并 - 主干是
develop：把上面命令里的main换成develop - CI/CD 自动生成的临时分支（如
pr-123、pipeline-test-7）可跳过检查，但得确认对应流水线状态为success或cancelled
删完远程，本地还显示 origin/xxx？这是缓存没清
git push origin --delete branch-name 成功后，git branch -r 仍能看到 origin/branch-name，这不是删失败了，而是本地保留了远程引用快照。
必须手动清理，否则下次 git pull 可能出错，或干扰分支筛选逻辑：
- 清理失效的远程跟踪分支：
git fetch --prune或简写git fetch -p - 如果想一次清掉所有已不存在的远程分支引用，用
git remote prune origin - 注意：
git fetch -p不会删除本地同名分支（如branch-name），那得单独执行git branch -d branch-name
批量删远程分支时，别信管道命令
像 git push origin --delete $(git branch -r | grep 'origin/feature/old') 这类写法看着省事，实际风险极高：
- 分支名含空格、换行或特殊字符时，shell 分词会出错，可能删错分支甚至触发语法错误
- 网络中断或权限拒绝导致部分成功、部分失败，你根本不知道哪些删了、哪些没删
- 没有预览，无法二次确认
安全做法是分两步：先列出候选分支，人工核对；再逐个执行。
例如，查所有以 feature/old- 开头的远程分支：git ls-remote --heads origin | grep 'feature/old-' | cut -f2，输出是干净的分支名列表，复制粘贴执行更稳妥。
真要写脚本，务必在 git push 前加 echo 预览，比如：echo "will delete: $branch"; git push origin --delete "$branch"。
