Git本地分支已被仓库删除，如何切换到远程新分支？

核心原因 #

本地仓库的远程分支缓存未同步，导致无法识别远程新增的分支，同时还保留着已被远程删除的分支信息。

解决步骤 #

1. 更新本地远程分支索引
   执行以下命令拉取远程最新的分支数据，并清理本地已失效的远程分支引用：

   git fetch --prune
   

   --prune参数会自动删除本地中对应远程已删除的分支记录，确保本地索引和远程完全同步。

2. 确认远程分支存在
   查看所有远程分支，确认目标新分支已在列表中：

   git branch -r
   

   输出会以origin/<分支名>的形式展示所有远程分支。

3. 切换到目标远程分支

   • 如果本地还没有对应的分支，直接执行（Git 2.23及以上版本推荐用switch）：

     git switch <远程分支名>
     

     或者用传统的checkout：

     git checkout <远程分支名>
     

     这两个命令都会自动在本地创建一个与远程分支对应的跟踪分支。
   • 若需要自定义本地分支名称，可手动创建并跟踪：

     git checkout -b <自定义本地分支名> origin/<远程分支名>
     

内容的提问来源于stack exchange，提问作者Praveenchris 2808