Git浅克隆后无法查看远程分支的原因及解决方法

核心原因 #

浅克隆时Git默认会开启单分支拉取限制，仅同步克隆时的默认分支引用，即便后续执行git fetch --unshallow转为完整仓库，原有拉取规则也不会自动更新，因此无法获取其他远程分支的信息。

具体操作 #

• 先确认当前拉取规则是否异常，执行命令：
  git config --get remote.origin.fetch
  如果返回结果为+refs/heads/[默认分支名]:refs/remotes/origin/[默认分支名]（常见如+refs/heads/main:refs/remotes/origin/main），说明规则确实被限制仅拉取单个分支。
• 修改拉取规则为同步所有远程分支：
  git config remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*"
• 重新执行全量拉取：
  git fetch origin

结果验证 #

执行git branch -r即可查看所有远程分支，需要切换到对应分支时直接执行git checkout <分支名>，Git会自动创建关联远程的本地分支，无需手动提前创建。
如果需要确认仓库已经是完整非浅克隆状态，可执行git rev-parse --is-shallow-repository，返回false即为正常。

补充：如果后续需要浅克隆且要同步所有远程分支，可直接在克隆时添加参数git clone --depth 1 --no-single-branch [仓库地址]，就能避免后续看不到其他远程分支的问题。

内容的提问来源于stack exchange，提问作者Hebron Watson