git重命名远程分支本质是删旧推新+修复追踪三步操作；git branch -m仅改本地分支名，不触碰远程，必须手动删除旧远程分支、推送新分支并设置上游，否则导致ci/cd错乱、pr关联失效、本地推送仍指向旧名。
Git 没有直接重命名远程分支的命令，所谓“重命名远程分支”，本质是删旧推新+修复本地追踪关系三步操作。漏掉任何一步，都会导致远程残留旧分支、本地 git push 仍指向旧名、CI/CD 继续跑错分支。
git branch -m 只改本地，不碰远程
git branch -m 是唯一标准方式，但它只修改 .git/refs/heads/ 下的本地引用文件，对远程仓库零影响。
- 当前在待重命名分支上：直接运行
git branch -m new-name - 不在该分支上：必须写全旧名和新名，
git branch -m old-name new-name - 如果
new-name已存在，Git 报错：fatal: A branch named 'xxx' already exists. - 重命名后立刻执行
git status，大概率看到提示：Your branch is based on 'origin/old-name', but the upstream is gone.——这是上游跟踪断裂的明确信号
远程分支必须手动删旧 + 推新
远程仓库不支持原子性重命名，只能靠 git push --delete + git push origin new-name 组合实现。不删旧分支，会导致 PR 关联错乱、权限策略失效、CI 触发双跑。
- 先确认旧分支是否还存在：
git ls-remote --heads origin old-name（有输出才需删） - 删除远程旧分支（推荐）：
git push origin --delete old-name - 推送新分支并设置上游（关键）：
git push -u origin new-name（-u会自动写入branch.new-name.merge和branch.new-name.remote配置） - 不要用
git push origin :old-name—— 可读性差，部分 CI 工具无法识别冒号语法
上游跟踪关系必须显式修复
git branch -m 不会更新任何配置项，旧的 branch.old-name.merge 仍留在 .git/config 中。这会导致 git pull 默认拉取 origin/old-name，即使它已不存在。
- 如果还没推新分支，先
git push origin new-name，再git branch --set-upstream-to=origin/new-name - 如果已推新分支，可一步到位：
git push -u origin new-name - 若想彻底清理旧配置，先
git branch --unset-upstream，再绑定新上游 - 协作者同步时，不能只
git pull；必须git fetch --prune清理已删除的origin/old-name远程追踪分支
最易被忽略的是：重命名后未通知团队，或有人在旧分支上仍有未推送提交。一旦远程旧分支被删，这些提交就彻底丢失，且无法通过常规 fetch 恢复。操作前务必确认所有协作者已同步、无未推送变更。
