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 Hub Projects V2

使用 gh project CLI 管理 GitHub Projects v2。在代理需要列出待办事项、设置项目字段（如状态、迭代、优先级等）时使用此技能。

下载

• 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

注意：如果远程分支有保护规则（如 GitHub 的 branch protection），git push origin :old-name 可能被拒绝，这时得手动去平台界面关闭保护再删——脚本没法绕过权限控制。