重命名当前分支的正确命令是 git branch -m new-branch-name，仅修改本地分支指针，不改动提交历史和远程分支；需手动同步远程：先 git push origin --delete old-name，再 git push origin -u new-name。
重命名当前分支的正确命令是 git branch -m
直接运行 git branch -m new-branch-name 即可重命名当前所在分支。这个命令只影响本地分支，不会触碰远程仓库。
常见错误是误用 git branch -M（大写 M），它强制重命名，仅在目标分支名已存在时才需要——多数情况不需要加 -M，用 -m 更安全。
- 如果新分支名已存在，
git branch -m会报错：error: A branch named 'xxx' already exists. - 重命名后，原分支名彻底消失，Git 不保留历史引用，别名或旧指针都不会自动更新
- IDE（如 VS Code、JetBrains）可能缓存旧分支名，需手动刷新或重启 Git 面板
重命名后必须同步更新远程分支
重命名本地分支不会自动 rename 远端对应分支。你得手动删旧 remote 分支、推新分支，并重置上游跟踪。
典型操作链：
git push origin --delete old-branch-name<br>git push origin -u new-branch-name
注意：git push origin :old-branch-name 也能删远端分支，但易被误读为“推送空内容”，--delete 更清晰、不易出错。
- 如果其他协作者已在本地 checkout 了
old-branch-name，他们执行git fetch后会看到该分支变成 “stale”（过期），需手动清理：git branch -d old-branch-name -
git branch -u origin/new-branch-name可单独设置上游，但不如git push -u一步到位
切换分支再重命名？没必要
git branch -m 要求你在待重命名的分支上，但它不要求该分支“干净”——即使有未提交变更、甚至有未合并的 commit，也能重命名。
- 重命名操作不改变任何 commit 内容、不触发 merge 或 rebase，纯属指针改名
- 唯一限制：不能在
detached HEAD状态下运行git branch -m，会报错fatal: You are on a detached HEAD. - 如果当前分支正在被 rebase 或 cherry-pick 中，Git 允许重命名，但建议先完成操作再改名，避免混淆状态
别漏掉配置项 branch.autoSetupMerge
重命名后新建的分支默认不会自动关联远程同名分支，除非你开了自动设置 upstream 的开关：
git config --global branch.autoSetupMerge always
否则每次 git push -u 都得显式加 -u，否则后续 git pull 会提示 “no upstream configured”。这个配置不影响重命名本身，但会影响后续协作效率。
容易被忽略的是：这个配置对已存在的分支无效，只作用于未来新建或重命名后的首次 push。
