git branch -m 仅重命名本地分支，需手动执行 git branch --unset-upstream 和 git branch --set-upstream-to=origin/new-name 同步远程跟踪；若远程无新分支则先 git push -u origin new-name；删远程旧分支用 git push origin --delete old-name；VSCode 1.90+ 才支持 Git: Rename Branch 命令，且不自动处理远程同步。
git branch -m 重命名后远程跟踪失效
直接用 git branch -m new-name 只改了本地分支名，原远程跟踪信息（比如 origin/old-name）不会自动更新，git status 会显示“Your branch is based on 'origin/old-name', but the upstream is gone.”
- 必须手动删掉旧的上游设置：
git branch --unset-upstream - 再绑定新分支到远程同名分支：
git branch --set-upstream-to=origin/new-name - 如果远程还没有
new-name分支，得先推送一次：git push -u origin new-name
VSCode 内置 Git UI 不支持重命名操作
VSCode 的源代码管理侧边栏、命令面板里的 “Git: Rename Branch” 命令在 1.90+ 版本才加入，老版本或某些工作区配置下该命令根本不会出现 —— 它不是靠 Git 扩展“模拟”的，而是调用了底层 git branch -m，所以仍需后续手动同步远程。
- 确认可用：按
Ctrl+Shift+P（macOS 为Cmd+Shift+P），输入Git: Rename Branch看是否列出 - 若无此命令，别硬找 UI 入口，直接开集成终端敲命令更稳
- VSCode 不会帮你处理
git push --delete origin old-name，删远端旧分支得自己来
重命名后如何安全删除远程旧分支
本地分支名变了，但远程还留着 old-name，不清理会造成混淆，尤其团队协作时别人可能还在基于它工作。
- 删远端分支前，先确认没人正在用：
git ls-remote --heads origin old-name有输出才说明存在 - 执行删除：
git push origin --delete old-name（注意不是-d，某些旧版 Git 不支持缩写） - 删完立刻推新分支并设上游：
git push -u origin new-name，否则下次git pull会报错 - 别用
git push origin :old-name这种古早写法，可读性差，CI/CD 工具解析容易出错
重命名涉及 HEAD 分离或 rebase 后的注意事项
如果你刚执行过 git rebase 或从某个 commit 检出了分离 HEAD，此时当前“分支”其实没名字，git branch -m 会报错：fatal: Cannot rename the current branch while not on any branch.
- 先确认当前是否在命名分支上：
git symbolic-ref --short HEAD，有输出才是正常分支 - 如果输出为空，说明处于分离 HEAD 状态，得先
git checkout -b new-name创建并切换 - 重命名操作本身不改变提交历史，但若分支被多人追踪，重命名 + 删远端旧分支 = 强制覆盖协作上下文，务必提前同步
