当前分支上直接运行git branch -m 新分支名即可安全重命名，git会校验新名合法性（不能含空格、不能以-开头、不能与现有分支同名），失败报错不静默覆盖；远程需手动删旧分支、推新分支并设上游，否则协作链路中断。
当前分支上怎么安全重命名
直接运行 git branch -m 新分支名 就行，不用切走、不用写旧名。Git 会校验新名合法性（比如不能含空格、不能以-开头、不能和已有分支同名），失败就报错，不会静默覆盖或误操作。
常见错误是：当前在 main 分支，却执行 git branch -m feat/login feat/auth——Git 不报错，但只是把 main 改成 feat/auth，原 feat/login 完全没动。
- Windows 下大小写不敏感，
git branch -m main Main可能无反应，得加--force；但先确认本地没有叫Main的分支，否则会冲突 - 新名含点号或波浪线（如
hotfix.1.2）必须用引号：git branch -m "hotfix.1.2" "fix/1.2" - 如果新名已存在，命令直接失败，不会覆盖——这是保护机制，不是 bug
不在目标分支时怎么重命名
必须显式写出旧名和新名：git branch -m 旧分支名 新分支名。Git 不会在你不在该分支时“自动定位”，它只按字面意思删掉旧引用、建个新引用。
旧名拼错（比如少个斜杠、大小写不对），Git 不会报错，而是新建一个叫新名的分支，原分支原封不动留在那里——表面看像成功了，实际什么都没改。
- 旧分支名必须和
git branch列出的完全一致，包括大小写、斜杠方向 -
origin/xxx这类远程跟踪分支不是本地分支，不能用git branch -m操作，会报fatal: Branch 'origin/xxx' not found - 重命名后，
git status通常会提示Your branch is based on 'origin/旧分支名', but the upstream is gone——说明上游跟踪断了，不是 Git 坏了，是还没处理远程
远程分支怎么同步更新
Git 没有“重命名远程分支”这回事。所谓同步，本质是三步：删掉远程旧引用、推送新分支、重建上游跟踪。漏掉任何一步，协作就会出问题——CI 可能双跑、PR 关联错乱、别人 git pull 还指向已删除的分支。
- 先确认远程真有旧分支：
git ls-remote --heads origin 旧分支名，有输出才删 - 删远程旧分支用：
git push origin --delete 旧分支名（别用git push origin :旧分支名，shell 解析易出错，CI 工具也常不兼容） - 推新分支并设上游：
git push -u origin 新分支名；如果远程还没这个分支，-u会创建它并绑定跟踪；如果已有，-u只更新配置 - 如果已经推过新分支但没设上游，再补一句：
git branch --set-upstream-to=origin/新分支名 新分支名
协作者怎么同步重命名后的分支
他们不会自动感知变化。没人会因为你在远端删了 feat/login-temp、推了 feat/login，就让本地分支自动切换跟踪目标。
必须手动通知团队，并让他们各自执行清理：
- 先
git fetch origin拉取最新远程分支列表（含删除和新增） - 检查是否还残留
origin/旧分支名：git branch -r，如果还有，运行git branch -r -d origin/旧分支名删除本地远程跟踪引用 - 切换到对应本地分支，运行
git branch --set-upstream-to=origin/新分支名 - VS Code、JetBrains 等 IDE 常缓存分支信息，重命名后可能仍显示旧名或推送目标错误，需手动刷新或重启项目
最容易被忽略的是上游跟踪残留和远程分支未清理——这两点不处理，表面看分支名改了，实际 git push 和 git pull 依然指向已不存在的远程分支，协作链路从第一步就断了。
