Git浅克隆场景下如何检出指定远程分支并复用本地已有对象

核心原因说明 #

你执行git fetch --depth 1 origin <分支名>后看不到分支，是因为git clone --depth 1默认只会配置master分支的远程拉取映射，其他分支的拉取结果只会临时存放在FETCH_HEAD，不会生成正式的远程跟踪分支。

操作步骤 #

• 第一步：执行带明确分支映射的浅拉取命令，将目标分支同步为本地可识别的远程跟踪分支，替换命令中的<目标分支名>为你要拉的实际分支名：

git fetch --depth 1 origin <目标分支名>:refs/remotes/origin/<目标分支名>

该命令只会拉取目标分支最新1次提交对应的增量内容，Git会自动复用本地已有的master分支共享对象，不会重复下载已有内容。

• 第二步：拉取完成后，直接检出该分支生成本地跟踪分支即可：

git checkout -b <本地分支名> origin/<目标分支名>

如果你使用Git 2.23及以上版本，也可以用更直观的switch命令：

git switch --track origin/<目标分支名>

可选优化配置 #

如果后续需要频繁拉取多个不同远程分支，可以修改远程仓库的拉取规则，让所有远程分支都支持按深度拉取，无需每次写全映射路径：

git config remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*"

配置完成后，后续拉取其他分支只需要执行git fetch --depth 1 origin <目标分支名>即可自动生成对应的远程跟踪分支。

验证方法 #

执行git branch -r即可看到已拉取的所有远程分支列表，确认目标分支存在后即可正常进行后续操作。 #

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