Git远程分支已存在（git ls-remote可查）但无法检出的问题

为什么常规git fetch操作没效果？ #

Git默认的fetch规则（refspec）只会同步两类远程分支：

• 本地已存在且关联了远程追踪关系的分支
• 仓库配置中指定的默认分支（比如main/master）

如果本地从未创建过foobar分支，也没调整过fetch配置拉取所有远程分支，那么git fetch --all或git fetch origin不会把远程的foobar分支同步到本地的远程追踪引用（refs/remotes/origin/foobar）。这就导致：

• git branch -a看不到该分支（本地无对应追踪引用）
• git checkout refs/heads/foobar失败（refs/heads/是本地分支命名空间，本地根本没有这个分支）

git fetch origin foobar:foobar的作用原理 #

这条命令是指定了精确的refspec执行拉取，冒号前后的部分分别对应远程和本地的引用：

• 前半段foobar：指代远程origin仓库的refs/heads/foobar分支
• 后半段foobar：告诉Git在本地创建refs/heads/foobar分支，并把远程分支的内容同步到这里

这个操作不仅拉取了远程分支的代码，还自动建立了本地分支和远程分支的追踪关系，后续用git pull就能直接同步该分支的更新。

其他可选操作方式 #

如果只想先同步远程分支到本地追踪引用，不直接创建本地分支，可以执行：

git fetch origin refs/heads/foobar:refs/remotes/origin/foobar

执行后git branch -a就能看到remotes/origin/foobar，之后通过git checkout foobar或git switch foobar就能创建本地分支并自动关联远程分支。

内容的提问来源于stack exchange，提问作者Cornelius Roemer