git clone 失败的解决方法

whY的笔记

已于 2025-04-09 09:57:36 修改

阅读量4.4k

点赞数 11

文章标签： git

于 2024-10-20 08:20:48 首次发布

本文链接：https://blog.csdn.net/Yhw20040823/article/details/143087862

版权

本人在使用 git clone 命令时，经常失败。看了许多网上已有的帖子，其方法并非十分有效。因此，我结合个人经验，总结出这篇文章。以方便大家解决git clone失败的问题。

Why？递归克隆能成功？递归克隆的原理是什么？

错误信息描述

error: RPC failed; curl 18 transfer closed with outstanding read data remaining
error: 6801 bytes of body are still expected
fetch-pack: unexpected disconnect while reading sideband packet
fatal: early EOF
fatal: fetch-pack: invalid index-pack output

Why?为什么会出现这个问题呢？

这是因为网速较慢，或者所需要git clone 的目标项目太大

解决方法

Step1.改变配置

注意：在其他帖子中，一般把以下3条分别作为3种不同方法描述。

而经本人实践发现，把下面3条一起用更加有效！！！

1.1.增大缓冲区大小

在终端输入以下命令即可设置：

git config --global http.postBuffer 524288000

这里表示把git clone的缓冲区设置为524288000B=500MB

1.2.调整最低网速和时间

在终端输入以下命令即可设置：

git config --global http.lowSpeedLimit 0
git config --global http.lowSpeedTime 999999

1.3.更改通信协议

因为git默认使用http/2.0协议，而github还是http/1.1 。 git 默认使用的通信协议是http/1.0，可以通过将默认通信协议修改为 http/1.1 来解决该问题

在终端输入以下命令即可设置：

git config --global http.version HTTP/1.1

建议：把上面的1.1、1.2、1.3一起使用

然后再进行Step2

1.4.查看更改后的结果

git config --global --list

Step2.改变克隆方式

一般的克隆方式：
```
git clone http://github.com/<file name>
```
当出现以上报错信息时，建议把克隆方式改为下面这种：

先浅克隆，再获取完整内容:（<--建议使用）

git clone http://github.com/<file name> --depth 1
cd <file name>
git fetch --unshallow

实践发现：一般git clone命令，在白天的成功率>晚上的成功率

假如你已经按照Step1配置好，但是采用“先浅克隆，再获取完整内容”的方式仍然失败，可以再尝试多几次。因为可能不是你这边的网速不好，而是别人的服务器那边太繁忙。

这个东西需要一点运气

最后：

奉上一个血与泪的教训：

假如克隆成功后，发现代码编译会报错，报错信息显示缺乏某些头文件

这时，请首先尝试采用以下的克隆方法：

递归克隆

$ git clone --recursive http://github.com/<file name>

使用这句命令克隆后，再编译，一般就能成功了

Why？递归克隆能成功？递归克隆的原理是什么？

不难发现，递归克隆法相比于一般的克隆方法多了1个“recursive”(表示“递归”)

实际上，你所要克隆的目标项目project1可能调用了A人的项目projectA，而A人的项目可能调用了B人的项目projectB，………

如果使用一般的克隆方法，则只会克隆目标项目project1，这会导致在编译时缺乏某些头文件而报错。

如果使用递归克隆法，则不仅会克隆目标项目project1，还会克隆projectA，projectB…………从而不会报错