Git bisect操作：如何仅克隆指定提交范围？浅克隆参数组合报错

问题背景 #

需要对仓库https://example.git执行git bisect，目标二分范围的两端均为旧提交：较新的za3bca和较旧的fabce1。由于带宽限制，不想下载该范围之外的所有提交。之前尝试同时使用--shallow-since=20220212和--depth=100参数克隆仓库时，触发错误：

fatal: 处理浅层信息出错: 4

错误原因 #

同时混用--shallow-since和--depth会让Git尝试同时基于日期和提交数量双重限制浅层克隆范围，这种叠加逻辑容易触发内部处理冲突，导致报错。

解决方案 #

方案1：单独使用--shallow-since克隆（推荐） #

利用已知的较旧提交日期，单独使用--shallow-since参数拉取该日期之后的所有提交，刚好覆盖bisect所需范围：

git clone https://example.git --shallow-since=2022-02-12 --no-single-branch

• --no-single-branch是必要参数：确保克隆所有分支的相关提交，避免bisect时无法访问目标提交。

验证提交可用性

克隆完成后，检查两个目标提交是否可访问：

git rev-parse --verify za3bca
git rev-parse --verify fabce1

若提示提交不存在，说明--shallow-since的日期设置过晚，调整为fabce1提交日期的前一天即可。

启动git bisect

确认提交存在后，正常执行bisect流程：

git bisect start
git bisect bad za3bca
git bisect good fabce1

后续按照Git提示测试中间提交即可。

方案2：基于提交范围逐次拉取 #

若无法确定准确日期，可先浅层克隆仓库，再逐步拉取目标提交范围：

1. 先克隆仓库最新的1个提交（最小带宽消耗）：

   git clone https://example.git --depth 1 --no-single-branch
   

2. 拉取目标提交fabce1和za3bca，设置足够覆盖两者间距的深度值（比如之前统计范围约100，设置150即可）：

   git fetch origin fabce1 --depth 150
   git fetch origin za3bca --depth 150
   

3. 验证提交存在后，按照方案1的步骤启动git bisect。

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