git重命名远程分支必须“删旧+推新+设上游”三步：先git branch -m old new改本地名，再git push origin --delete old删远程旧分支，最后git push origin -u new推送并设追踪，否则远程残留旧分支导致ci/cd和pr错乱。
本地分支重命名后，git push 报错 error: src refspec xxx does not match any
这是最常踩的坑：改完本地分支名，直接 git push origin new-name 会失败，因为远程还没有这个分支，Git 也不清楚你是不是想删旧分支、推新分支。关键点在于——Git 不会自动把重命名操作同步到远程，必须显式处理。
正确做法分两步：
- 先用
git branch -m old-name new-name完成本地重命名（注意：当前必须不在old-name分支上，否则会报错） - 再执行
git push --set-upstream origin new-name，这句既推送新分支，又设置跟踪关系 - 最后删掉远程旧分支：
git push origin --delete old-name
为什么不能只用 git push origin :old-name 删除远程分支？
这种写法虽然能删，但容易误操作：冒号前的空格一旦漏掉或写成 git push origin :old-name（多一个空格），命令就变成推送空分支，Git 会静默失败，远程分支还在。更稳妥的是用明确语义的 --delete 参数。
另外要注意权限：如果 old-name 是默认分支（比如 main），GitHub/GitLab 会拒绝删除，需先在 Web 界面修改仓库默认分支设置，再执行删除命令。
git branch -m 和 git branch -M 的区别在哪？
-m 是安全模式：目标分支名已存在时会报错，防止覆盖；-M 是强制模式：直接覆盖同名分支（不推荐日常使用）。绝大多数情况用 -m 就够了。
还有一点容易忽略：如果当前在要重命名的分支上，git branch -m 仍可执行，但某些旧版 Git（git checkout main（或其他稳定分支），再操作重命名。
团队协作中，分支重命名后队友该怎么同步？
他们不需要手动删本地旧分支。只要运行一次 git fetch --prune（或简写 git fetch -p），Git 就会自动清理本地对已删除远程分支的跟踪引用。之后再 git checkout new-name 即可拉取新分支。
但要注意：如果队友本地还有未合并的 old-name 提交，git fetch -p 不会动它，得靠人确认是否需要保留或 cherry-pick 过去。重命名不是原子操作，沟通比命令更重要。
fetch -p，这点最容易被跳过。
