git clone --depth 1 --single-branch -b main https://example.com/repo.git git fetch --deepen=50
拉取一个历史很大的仓库时反复超时断开，重试也一直卡在接收对象阶段。这类现象通常不是突然出现的，往前翻半天日志能看到苗头。
追下去是这么回事：完整克隆需要下载全部历史与所有分支，网络不稳时很容易中断。
「git 浅克隆」排查到最后往往是很小的一处差异，前面那些复杂猜测可以先放一放。权限不要一口气开到最大，先加到够用再往上试，范围小才好收。
把复现步骤压到三条以内，交给同事也能跑出来，才算真的定位清楚。改动写完就同步给同事，下一个人踩同一个坑，成本还是你的。
验证用真实数据走一遍，测试数据太干净，边界情况根本碰不到。能分两步做的操作就别合成一步，中间看一眼返回值，出问题好判断。
处理上按这个顺序：只拉最近一次提交；只拉目标分支；需要历史时再逐步加深。
确认没问题再收工，仓库能成功克隆，文件完整，后续可正常提交与拉取。