必须同时使用 -b 和 --single-branch 才能准确克隆指定分支，单独用 --single-branch 会依赖远程 head（可能非预期分支），甚至失败；正确命令为 git clone -b --single-branch 。
git clone -b 和 --single-branch 必须一起用才有效
单独写 --single-branch 不会按你心里想的分支拉，它只认远程仓库的 HEAD 指向——可能是 main，也可能是早就设成 next 或 dev 的分支。如果远程没设 HEAD（比如裸仓库、CI 构建产出库），命令直接失败并报错：remote HEAD refers to nonexistent ref。
正确写法必须显式指定分支名：
git clone -b main --single-branch https://github.com/user/repo.gitgit clone -b release/v2.3 --single-branch https://gitlab.example.com/team/proj.git
不加 -b 时，--single-branch 实际行为不可控，不是“省事”，而是埋坑。
--depth=1 和 --single-branch 组合才是最小体积方案
浅克隆本身默认只拉一个分支，但某些 Git 版本（尤其是 2.30 之前）仍会在 .git/refs/remotes/origin/ 下创建空引用，虽不占对象空间，却多出冗余元数据。显式加 --single-branch 是保险做法。
组合使用后，本地只剩目标分支最新一次提交的完整快照，体积通常比全量克隆小 60% 以上，尤其对历史长、分支多的仓库效果显著：
git clone -b feat/api-v2 --single-branch --depth=1 https://github.com/user/repo.git- 克隆后
du -sh .git一般在几百 KB 到几 MB 级别，而非几十 MB 起步
注意：--depth=1 后无法 git log 查历史，也不能 git checkout 其他 commit——这不是 bug，是设计如此。
克隆完还看到一堆 origin/* 分支？那是假象，不是真数据
执行 git branch -r 仍显示大量 origin/xxx，容易误以为“没生效”。其实这些只是 remote tracking refs，存在 .git/refs/remotes/origin/ 下的空文件或符号引用，不占用 .git/objects/ 空间，对磁盘体积几乎无影响。
如果连这点引用都想清理干净，克隆后立刻运行：
-
git remote set-branches origin "target-branch"→ 把远程跟踪分支列表锁死为单个 -
git fetch --prune→ 清掉本地已不存在的origin/xxx引用
不需要删 remote 再重配，除非你明确要重置整个 remote 配置。
稀疏克隆（sparse-checkout）适合只取子目录，但需两步走
如果目标不是“单分支”，而是“单目录”（比如只要 src/utils/），--single-branch 不管用，得用稀疏克隆：
- 先用
git clone --filter=blob:none --sparse URL拉下骨架（commit/tree/tag，不含文件内容） - 再进目录执行
git sparse-checkout add src/utils，触发下载对应 blob
这比全量克隆快得多，但要注意：--filter=blob:none 之后首次 sparse-checkout add 会触发网络请求下载实际文件，不是纯本地操作；且该模式下 git status 可能显示大量未跟踪文件，属正常现象。
真正难的是判断该用哪种策略：要分支结构和历史？选 --single-branch + --depth；只要某几个文件夹且仓库巨大？上 --filter=blob:none + sparse-checkout。混用或漏步骤，体积就省不下来。
