git不自动同步远程分支重命名，因本地仓库不会监听远端变更，需团队成员手动执行四步：git fetch --prune origin、git branch -m旧名新名、git checkout新名、git branch --set-upstream-to=origin/新名，否则仍卡在旧追踪关系导致push/pull失败。
分支重命名后，团队成员不手动同步，本地分支就永远卡在旧名、旧追踪关系上，git pull 和 git push 都会失败或错推到已删除的远程分支。
为什么 git branch -m 后队友的本地仓库不会自动更新
Git 本地仓库不会监听远程分支名变更。远端把 feature/login-v2 改成 feature/auth-refactor，你的本地 .git/refs/heads/feature/login-v2 文件照旧存在，.git/config 里仍存着 branch.feature/login-v2.merge 这类配置。Git 不会主动删掉旧分支引用，也不会自动创建新分支或修复上游——它只认你本地当前有的东西。
常见错误现象包括：
-
git status显示Your branch is based on 'origin/feature/login-v2', but the upstream is gone -
git pull报错unable to resolve reference 'refs/remotes/origin/feature/login-v2' - IDE（如 VS Code、IntelliJ）右下角仍显示旧分支名，且无法正常 fetch/push
团队成员必须执行的四步本地同步操作
每个协作者需在自己本地仓库中依次执行以下命令（顺序不能乱，否则追踪关系会错）：
- 运行
git fetch --prune origin：拉取远端最新分支列表，并自动清理本地已不存在的远程分支引用（比如删掉origin/feature/login-v2） - 用
git branch -m feature/login-v2 feature/auth-refactor重命名本地分支（若当前不在该分支上，必须写全两个参数） - 切换到新分支并重建追踪：
git checkout feature/auth-refactor && git branch --set-upstream-to=origin/feature/auth-refactor - 验证是否生效：
git branch -vv应显示feature/auth-refactor abc123 [origin/feature/auth-refactor] Commit message，而非挂靠在旧名上
如何批量检查团队成员是否完成同步
作为分支负责人，你可以用一条命令快速扫描所有协作者的本地状态（需他们提前推送过新分支）：
使用约定式提交信息暂存、提交和推送git更改。当用户想要提交和推送更改、提到推送到远程、或要求保存并推送工作时触发。也适用于用户说“推送更改”、“提交并推送”、“推送这个”、“推送到github”或类似git工作流程请求时。
先让所有人执行 git fetch origin，然后你在本地运行：
git ls-remote --heads origin | grep -E 'login-v2|auth-refactor'
如果输出中只有 refs/heads/feature/auth-refactor，说明远端已清理干净；再结合 git branch -r 查看各人本地 origin/ 引用是否还残留旧名。真正难发现的是那些没跑 --prune 的人——他们的 git branch -r 里仍会列出 origin/feature/login-v2，但实际这个引用早已失效。
通知时必须明确写出命令和验证方式
发消息别只说“分支已重命名，请同步”，要直接给可复制粘贴的命令块，并强调验证步骤。最容易被跳过的就是 --prune 和 git branch -vv 检查。很多人以为 git pull 就够了，结果只是触发一次失败的合并尝试，反而把问题埋得更深。通知模板建议包含：
- 旧名 → 新名映射（加
<code>包裹） - 四步命令（每行一个，不合并）
- 验证命令和预期输出（比如
git branch -vv中应出现[origin/feature/auth-refactor]） - 提醒 IDE 缓存问题：VS Code 需点右下角分支名刷新，IntelliJ 要
VCS → Git → Branches → Remote Branches → Reload project
没人会为一次分支重命名专门查文档。你给的命令越完整、验证越具体，团队踩坑的概率就越低。最麻烦的不是重命名本身，而是有人漏掉一步后，默默把新功能推到了一个早已被删掉的远程分支上——而他自己完全没意识到。
