git不支持直接重命名当前分支，需先切换至其他分支（如git checkout main），再用git branch -m old-name new-name重命名，最后切回；若已推送到远程，须git push origin --delete old-name删除旧分支并git push origin -u new-name推送新分支。
当前在目标分支上，想直接改名
Git 本身不支持“修改当前分支名”，必须先切换到其他分支再操作，否则会报错 error: Cannot rename the currently checked out branch。这是硬性限制，不是权限或配置问题。
正确做法是：先切走，再重命名，最后切回来：
- 运行
git checkout main（或任意其他已有分支） - 执行
git branch -m old-name new-name（-m表示 move，即重命名） - 再
git checkout new-name切回新名字分支
注意：git checkout 在较新 Git 版本中建议换成 git switch，但 git switch 本身不支持重命名，仍得靠 git branch -m 配合。
已推送到远程，重命名后如何同步
本地重命名只是改了 .git/refs/heads/ 下的引用，远程仓库完全不知情。如果不处理远程，下次 git push 会失败，提示 src refspec old-name does not match any。
需要两步清理远程旧引用、推送新分支：
- 删除远程旧分支：
git push origin --delete old-name - 推送本地新分支并设置上游：
git push origin -u new-name
如果原分支有其他人正在协作，务必提前通知——因为 --delete 是不可逆操作，且重命名后 commit 历史虽不变，但分支指针已迁移，他人 fetch 后需手动更新跟踪关系。
想把当前分支改成 main，但 main 已存在
直接 git branch -m main 会失败，报错 fatal: A branch named 'main' already exists。Git 不允许覆盖已有分支名。
必须显式删掉冲突分支（前提是确认可以删）：
- 先删本地同名分支：
git branch -D main（-D强制删除，无视是否已合并） - 再重命名当前分支：
git branch -m main - 如该
main原本是远程跟踪分支，还需运行git branch -u origin/main重新关联上游
这个操作风险较高，尤其在团队共用默认分支时，别在未沟通情况下把本地 feature 分支强行改成 main 并推送到远端。
重命名后，Git GUI 或 IDE 显示异常
VS Code、JetBrains 系列、Sourcetree 等工具常缓存分支名或上游配置。重命名后可能仍显示旧名、标为“已过期”或推送目标仍是旧分支。
这不是 Git 本身问题，而是工具未及时刷新：
- VS Code：关闭再打开文件夹，或按
Ctrl+Shift+P→ 输入 “Git: Refresh” - IntelliJ IDEA：右键项目根目录 →
Git → Repository → Refresh - 命令行验证最可靠：
git branch看当前列表，git status看当前分支和上游是否匹配
有些 IDE 还会保留旧分支的 stash 或 local history 记录，这些不会自动迁移，得手动检查清理。
