git branch -m 不能直接更新远程分支名，因为git不会自动推送新分支、设置上游或删除旧分支。必须手动三步操作：重命名本地分支→推送新分支并设上游→删除远程旧分支，且需校验当前分支和远程分支存在性。
为什么 git branch -m 不能直接更新远程分支名
本地重命名分支后，远程仓库里旧分支还存在，新分支默认不会自动推送，更不会自动删除旧分支——Git 不会替你做这种有风险的联动操作。常见错误是只运行 git branch -m new-name 就以为完事，结果 git push origin :old-name 忘了执行，或者 git push origin new-name 没加 --set-upstream，导致后续 git pull 报错 “No upstream configured”。
一键脚本必须包含的三个原子操作
一个真正可用的自动化脚本，必须按顺序完成：重命名本地分支 → 推送新分支并设置上游 → 删除远程旧分支。漏掉任意一步都会留下不一致状态。
- 先用
git branch -m old-name new-name改本地名（注意：当前分支必须是待重命名分支） - 再用
git push origin new-name --set-upstream把新分支推上去，并绑定追踪关系 - 最后用
git push origin :old-name删除远程旧分支（冒号前空格不能少，这是 Git 的“删除远程引用”语法）
脚本里要校验的两个关键前提
直接硬执行上述命令容易失败。比如当前不在 old-name 分支上，git branch -m 就会报错；或者远程根本没有 old-name，git push origin :old-name 虽然不报错但会误删其他同名引用。所以脚本开头必须检查：
-
git rev-parse --abbrev-ref HEAD确保当前分支名等于预期的old-name -
git ls-remote --heads origin old-name | wc -l判断远程是否存在该分支（输出 >0 才执行删除）
实际可用的最小可行脚本示例
把下面保存为 rename-branch.sh，chmod +x 后运行 ./rename-branch.sh old-name new-name：
#!/bin/bash OLD=$1 NEW=$2 if [ -z "$OLD" ] || [ -z "$NEW" ]; then echo "Usage: $0 <old-name><new-name>" exit 1 fi if [ "$(git rev-parse --abbrev-ref HEAD)" != "$OLD" ]; then echo "Error: not on branch '$OLD'" exit 1 fi git branch -m "$OLD" "$NEW" git push origin "$NEW" --set-upstream if [ "$(git ls-remote --heads origin "$OLD" | wc -l)" -gt 0 ]; then git push origin ":$OLD" fi</new-name></old-name>
注意：如果远程分支有保护规则（如 GitHub 的 branch protection），git push origin :old-name 可能被拒绝，这时得手动去平台界面关闭保护再删——脚本没法绕过权限控制。
