git branch -m 新分支名是重命名当前分支的唯一可靠方式，仅修改本地分支指针，不改动提交历史；需手动删除远程旧分支、推送新分支并设置上游跟踪，否则导致协作混乱。
Git 本身没有“重命名当前分支”的原子命令，git branch -m 是唯一可靠方式，但它要求你**不能在待重命名的分支上直接执行**——等等，其实可以，只是很多人误用了参数或忽略了前提条件。
用 git branch -m 重命名当前分支（最简路径）
只要当前 HEAD 指向的是你要改名的分支，git branch -m 新分支名 就能直接生效。不需要先切到别的分支再操作。
常见错误是写成 git branch -m 旧名 新名 —— 这种双参数形式只适用于重命名**其他分支**，且当前不能在那个分支上；而单参数形式才是专为当前分支设计的。
- ✅ 正确（在 feature/login 分支上）：
git branch -m feat/auth-login - ❌ 错误（会报错 “Cannot rename the current branch”）：
git branch -m feature/login feat/auth-login - ⚠️ 注意：如果新分支名已存在，命令会失败，不覆盖
远程分支不同步？必须手动推送和删除
本地重命名后，远程仓库里还是旧分支名，Git 不会自动同步。你得自己推新分支、删旧分支。
这一步漏掉，协作时别人 git pull 仍会拉到旧分支，甚至可能意外重建它。
- 推送新分支：
git push origin -u feat/auth-login（-u设置上游跟踪） - 删除远程旧分支：
git push origin --delete feature/login - 可选：清理本地远程追踪引用（避免
git branch -r还显示旧名）：git remote prune origin
重命名后队友怎么更新？别让他们手动改配置
队友不需要运行 git branch -m。他们只需拉取变更、重置本地追踪关系即可。
错误做法是让每个人各自执行重命名——这会导致本地分支名不一致、上游设置错乱。
- 推荐做法（在队友机器上）：
git fetch origin→git checkout feat/auth-login→git branch --set-upstream-to=origin/feat/auth-login - 更稳妥（尤其当本地还有未推送提交）：
git checkout feature/login→git merge feat/auth-login→git branch -d feature/login - ⚠️ 如果队友之前有
feature/login的本地提交，不要直接删分支，先确认是否已合并
重命名分支真正麻烦的不是命令本身，而是上下游追踪关系的断裂和团队协同节奏——名字改得再快，没对齐远程和队友的本地状态，就等于没改完。
