git clone -b 必须配合 --single-branch 才真正只拉一个分支；否则仅创建远程分支引用而不下载对象，但残留空 ref 文件；显式组合 --single-branch 与 --depth=1 可最小化体积和时间，并确保跨版本行为一致。
git clone -b 必须配 --single-branch 才真只拉一个分支
只写 git clone -b feat/login https://github.com/user/repo.git，本地仓库里依然会包含所有远程分支的引用（origin/develop、origin/release/v2.3 等），虽然不下载对象数据，但 .git/refs/remotes/origin/ 下会残留一堆空 ref 文件。这不是 bug，但容易让人误以为“已经干净了”。
真正跳过其他分支历史对象的唯一方式是显式加 --single-branch：
-
git clone -b feat/login --single-branch https://github.com/user/repo.git→ 只请求 feat/login 分支的提交链，服务器不会发其他分支的 commit、tree、blob 对象 - 不加
-b却用--single-branch→ 默认拉远程 HEAD 指向的分支（可能是next或staging，而非你预期的main） - 某些裸仓库或 CI 产出库没设远程 HEAD，此时命令直接失败，报错：
remote HEAD refers to nonexistent ref
--depth=1 和 --single-branch 组合才是最小体积方案
浅克隆本身默认启用 --single-branch（Git 2.20+），但不同版本行为不一致：旧版 Git 在只用 --depth=1 时，仍可能在 .git/refs/remotes/origin/ 下创建空引用。显式写出两者，才能确保跨版本稳定。
典型高效命令：
git clone -b main --single-branch --depth=1 https://github.com/user/repo.git- 体积通常压到几 MB（完整克隆可能是几百 MB），克隆时间从分钟级降到秒级
- 注意：
git log只显示一条提交，git checkout abc123会失败 —— 这不是缺陷，是浅克隆的设计约束
克隆完看到 origin/xxx 分支列表？那只是引用，不占空间
执行 git branch -r 仍看到一堆 origin/feature/xxx？别慌。这些只是 .git/refs/remotes/origin/ 下的符号链接或空文件，不指向任何实际对象，.git/objects/ 里只有你指定分支的压缩数据。
使用约定式提交（Conventional Commits）从 Git 历史记录中生成结构化变更日志，支持多种格式、AI 增强型描述以及可自定义的范围……
如果你连这点元数据都不想要（比如构建镜像需极致精简），克隆后立刻 prune：
-
git remote set-branches origin 'main'→ 把 origin 的跟踪分支白名单设为仅 main -
git fetch --prune→ 清掉本地已失效的 remote tracking refs
这步不是必须的，但能让你的 git branch -r 输出真正干净。
CI/CD 脚本里别省略 --single-branch
自动化流程中，--depth=1 常被当作“够快就行”的默认项，但漏掉 --single-branch 会导致两个隐性问题：
- 某些 Git 服务（如自建 Gitea 或旧版 GitLab）在响应
--depth=1请求时，仍会推送部分无关分支的 ref advertisement，增加网络往返和解析开销 - 后续执行
git checkout -b my-branch origin/other-branch可能意外成功（因为 ref 存在），但实际没对应 commit 对象，导致构建中途失败 - CI 缓存层（如 GitHub Actions cache）若基于
.git目录哈希，多出的 ref 元数据会让缓存命中率下降
所以，只要目标明确是单一分支，就始终写全：-b $BRANCH --single-branch --depth=1。少敲三个词，可能多花半小时排查。
