如何仅克隆master/main分支并按需拉取其他分支？

我太懂你这种大仓库的痛苦了——10GB的体量加上不停的提交，克隆慢不说，还动不动就出锁引用错误，完全打乱开发节奏。咱们来一步步解决这个问题：

一、正确克隆仅主分支的仓库 #

你之前用的git clone --no-single-branch --depth 1其实搞反了关键参数，要实现只克隆master分支，应该用下面的命令：

git clone --single-branch --branch master git@your-repo-url.git

如果你的主分支是main，就把master换成main就行。

这里的参数作用：

• --single-branch：告诉Git只克隆指定的分支（这里是master），不会拉取其他远程分支的本地副本，从根源上减少仓库体积和后续同步的麻烦。
• --branch master：明确指定要克隆的分支是master，和--single-branch配合使用，精准锁定目标分支。
• 如果想进一步提速，可以加上--depth 1，只拉取该分支的最新一次提交，克隆速度会快很多，仓库初始体积也会大幅缩小：

git clone --single-branch --branch master --depth 1 git@your-repo-url.git

二、按需拉取其他远程分支 #

当你需要用到某个远程分支（比如feature-login）时，有两种简单的方式：

1. 直接切换自动拉取（Git 2.23+版本支持）
   直接运行checkout命令，Git会自动检测本地没有该分支，然后从远程拉取并创建本地关联分支：

git checkout feature-login

2. 手动拉取并创建分支
   如果你的Git版本比较老，或者想更明确地控制，可以用fetch命令直接从远程拉取指定分支到本地：

git fetch origin feature-login:feature-login

执行完后，再切换到该分支：

git checkout feature-login

三、为什么你之前的命令没生效？ #

你用的git clone --no-single-branch --depth 1，其中--no-single-branch是告诉Git要保留所有远程分支的引用（哪怕是浅克隆），所以你还是会拿到所有分支的指针，只是每个分支只有最新提交。这既没实现只保留master的需求，后续pull时还是会因为要同步大量分支引用而出现锁引用错误，自然达不到你的预期。

额外小提示 #

如果是浅克隆的仓库，之后需要拉取某个分支的完整历史，可以在fetch时加上--unshallow参数：

git fetch origin feature-login --unshallow

这样就能获取该分支的全部提交记录了。

备注：内容来源于stack exchange，提问作者David Alsh