借助GitHub API在Git浅克隆中获取指定远程提交及对应深度

为什么你指定的--depth和实际提交数对不上？ #

你肯定会疑惑：明明设了--depth=4000，怎么最后得到了五万多个提交？其实Git的--depth参数根本不是直接统计提交数量，它的真实作用是指定从你要拉取的目标引用（比如默认的HEAD）往回追溯的提交链深度——但这里的“深度”是基于Git的提交图结构，一旦遇到合并提交，情况就会变得复杂。

举个简单的例子：如果HEAD是一个合并提交（它有两个父提交），哪怕你指定--depth=1，Git也会自动把这两个父提交一起拉取回来，因为合并提交的完整性依赖这两个节点。所以当你拉取的深度范围内包含多个合并节点时，Git会把所有这些合并节点的父提交都纳入进来，最终的提交数量自然会远超你指定的depth数值。

你用git rev-list HEAD ^042b84a --count得到的45283，是主分支上从HEAD到目标提交042b84a的线性提交数，但加上合并进来的其他分支提交，总数就会突破你设置的4000深度限制，这完全符合Git的设计逻辑。

为什么用GitHub API计算depth会翻车？ #

你之前尝试用API算depth的思路，踩了两个关键的坑：

• GitHub API的提交列表是按时间排序，不是分支提交链顺序：API返回的是仓库所有分支的提交按时间倒序排列的结果，而Git的提交链是基于分支的祖先关系，和时间顺序没有必然联系。比如某个旧分支的提交可能在时间上更晚，但在主分支的提交链里是更早的节点，所以用API分页算出的总数和主分支实际的提交链长度完全不匹配。
• since参数的过滤逻辑不对：用since筛选的是提交时间晚于指定日期的所有提交，这些提交可能散落在各种分支上，并非都属于主分支的提交链，所以计算出来的数量自然和你需要的深度无关。

老版本Git下获取特定提交的更高效姿势 #

既然你用的是Git 1.9.1（不支持直接拉取单个提交的功能，这个是Git 2.5+才有的），逐步增加depth是可行的，但可以调整策略更高效：

• 先从一个中等深度开始尝试（比如10000），然后用git cat-file -e 042b84a检查目标提交是否已经被拉取到本地；
• 如果不存在，就把depth翻倍（比如20000、40000），重复检查；
• 一旦能找到目标提交，直接git checkout 042b84a就能切换到该提交。

如果有条件升级Git到2.5以上，那操作会简单很多：先浅克隆仓库git clone --depth=1 --single-branch https://github.com/mozilla/gecko-dev，然后直接执行git fetch --depth=1 origin 042b84a就能精准拉取目标提交，不需要折腾depth数值。

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