vscode的git: rename branch命令不靠谱，它仅调用git branch -m重命名本地分支，不自动处理远程同步，需手动执行--unset-upstream、--set-upstream-to、push新分支及--delete旧分支。
VSCode 本身不自动同步重命名后的远程分支，git branch -m 只改本地名，远程仍指向旧分支，必须手动处理上游和远端删推 —— 这是绝大多数人踩坑的根源。
VSCode 的 Git: Rename Branch 命令到底靠不靠谱？
该命令在 VSCode 1.90+ 版本才内置，本质就是调用 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
如果你按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P）输入 “Git: Rename Branch” 没反应，说明你用的是老版本、禁用了 Git 扩展，或工作区配置屏蔽了该命令 —— 别硬找 UI，直接开集成终端敲命令更稳。
重命名后 git status 报 “upstream is gone” 怎么办？
这是最典型的症状：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
注意：顺序不能错，--set-upstream-to 对不存在的远程分支会报错，不是静默失败。
怎么安全删掉远程旧分支？别用 git push origin :old-name
这个古早写法虽然能删，但可读性差、CI/CD 工具解析容易出错，且不兼容部分老旧 Git 版本。推荐明确写法：
- 先确认远程还存在旧分支：
git ls-remote --heads origin old-name（有输出才删） - 再执行删除：
git push origin --delete old-name（注意是--delete，不是-d，后者在 Git - 删完立刻推新分支并设上游：
git push -u origin new-name，否则下次git pull会失败
团队协作中，删前最好在群内同步，避免别人还在基于 old-name 工作。
重命名前一定要检查是否在命名分支上
如果你刚 git rebase 完，或从某个 commit 直接 git checkout <commit-hash></commit-hash>，当前处于分离 HEAD 状态，git branch -m 会直接报错：
fatal: Cannot rename the current branch while not on any branch.
先运行：git symbolic-ref --short HEAD
如果输出为空，说明不在命名分支上 —— 此时不能重命名，得先 git checkout -b new-name 创建新分支，再考虑是否要合并或替换原分支逻辑。
