git branch -m只写一个参数时，表示将当前所在分支重命名为指定新名；它仅修改本地分支名，不触碰远程分支，需手动处理上游追踪和远程同步。
能重命名，但只改本地名不等于完成操作；远程分支不会自动同步，必须手动删旧推新，否则协作会出问题。
git branch -m 什么时候只写一个参数？
当前就在要改名的分支上时，直接用 git branch -m 新分支名。Git 会校验新名是否合法（比如不能以 - 开头、不能含空格、不能和已有分支同名），失败就报错，不会静默覆盖。
- 常见错误：误以为
git branch -m old new在当前分支上执行就能改old，其实它只会把当前分支改成new，old分支原封不动留在那里 - Windows 下大小写不敏感，
main→Main可能被忽略，需加--force显式触发（但先确认没歧义） - 旧分支名含特殊字符（如
.、~）必须用引号：git branch -m "hotfix.1.2" "fix/1.2"
git branch -m 后 git status 报 “upstream is gone” 怎么办？
重命名只动本地分支指针，远程跟踪信息（比如 origin/旧名）不会自动更新，所以 git status 会提示上游丢失。
- 先清除旧上游设置：
git branch --unset-upstream - 再绑定新上游：
git branch --set-upstream-to=origin/新分支名 新分支名 - 如果远程还没有
新分支名，得先git push -u origin 新分支名创建它
怎么安全删掉远程旧分支？
别跳过这步——远程留着旧分支，CI/CD 可能还在跑，别人 PR 还可能指向它。
- 先确认远程真有旧分支：
git ls-remote --heads origin 旧分支名有输出才删 - 删远程旧分支用：
git push origin --delete 旧分支名（别用:写法，可读性差、CI 工具易解析错） - 删完立刻推新分支并设上游：
git push -u origin 新分支名，否则下次git pull会报错
VSCode 能不能点两下就搞定重命名？
VSCode 1.90+ 自带 Git: Rename Branch 命令（Ctrl+Shift+P 输入即可），但它只是调用了 git branch -m，**不处理远程同步、不删旧上游、不推新分支**。
- 老版本或某些工作区配置下该命令根本不会出现，别硬找 UI 入口
- 它不会帮你执行
git push origin --delete 旧分支名，这一步必须自己敲命令 - 如果你刚
rebase或处于分离 HEAD 状态，git branch -m会直接报fatal: Cannot rename the current branch while not on any branch，得先git checkout -b 新分支名
最易被忽略的是远程分支残留和上游跟踪失效——这两点不处理，表面看分支名改了，实际协作链路已经断开。
