--depth=1 是唯一实用的浅克隆深度，因其仅拉取HEAD提交及关联tree/blob，体积最小、速度最快；--depth≥2会陡增网络开销却几乎无额外价值，且部分Git服务支持不稳定。
只设 --depth=1 就够了，其他值基本没意义，还可能引发意外行为。
为什么 --depth=1 是唯一实用的浅克隆深度
Git 的浅克隆不是“拉取最近 N 次提交”，而是“从最新提交往前截断 N 层”。--depth=1 表示只保留 HEAD 提交本身，不包含任何父提交 —— 这是真正意义上的“只取最新代码”。设成 --depth=2 或更大，不仅下载量翻倍，还会引入不必要的历史对象，且无法规避多数超时问题（比如 HTTP 504）。实际测试中，--depth=1 和 --depth=2 的耗时差异常达 3 倍以上，但带来的额外信息几乎为零。
-
--depth=1：只拉取单个 commit 对象 + 所有 tree/blob，体积最小、速度最快、兼容性最稳 -
--depth=2及以上：必须额外拉取父 commit 及其关联对象，网络开销陡增，且仍无法 checkout 其他分支 - 某些 Git 服务（如 Bitbucket Server）对
--depth > 1支持不稳定，容易返回fatal: bad object
--single-branch 必须和 --depth=1 配合使用
单独用 --single-branch 不会减少数据量 —— 它只是不创建远程分支引用（refs/remotes/origin/*），但所有分支的历史对象仍会被下载。只有和 --depth=1 组合，才能真正限制传输范围。
- 正确写法：
git clone --depth=1 --single-branch --branch develop https://github.com/org/repo.git - 错误写法：
git clone --single-branch https://github.com/org/repo.git（仍下载全部历史） - 漏掉
--single-branch：即使--depth=1，默认也会拉取所有远程分支的 HEAD 引用（虽不下载其历史，但增加元数据开销）
指定分支时，--branch 和 -b 效果完全一致
两者是同一参数的长格式与短格式，无功能差异。但要注意：--branch 后必须紧跟分支名，中间不能有空格；而 -b 同理。常见错误是把分支名拼错或用了不存在的分支，导致克隆后 git status 显示 “unknown branch”。
- 安全写法：
git clone -b main --depth=1 --single-branch <url></url> - 危险写法：
git clone -b "main " --depth=1 <url></url>（末尾空格导致分支名识别失败） - 分支名区分大小写，
main≠Main，建议先用git ls-remote --heads <url></url>确认真实名称
浅克隆后无法切换分支？这不是 bug，是设计使然
--depth=1 克隆出来的仓库，本地只有被指定分支的最新 commit，其他分支的 commit 对象根本没下载。所以 git checkout feature/x 会报错 error: pathspec 'feature/x' did not match any file(s) known to git。
- 这不是配置问题，是 Git 分布式模型的必然结果：没有对象，就无法检出
- 如果后续确实需要其他分支，只能用
git fetch --depth=1 origin feature/x单独拉取（注意：不是git pull） - CI/CD 场景下应避免依赖多分支切换，直接用
git clone -b $CI_COMMIT_REF_NAME --depth=1动态指定当前构建分支
真正关键的不是“怎么设 depth”，而是理解 --depth=1 意味着放弃历史追溯能力 —— 它不是优化选项，而是场景契约：你确认自己只需要这一份快照，且接受它不可回溯、不可跨分支检出的限制。
