Git克隆7GB GitHub仓库时遇RPC失败等错误求助

错误信息 #

克隆时触发的报错：

Cloning into 'fc'
remote: Enumerating objects: 19029, done.
remote: Counting objects: 100% (19029/19029), done.
remote: Compressing objects: 100% (11551/11551), done.
error: RPC failed; curl 18 transfer closed with outstanding read data remaining
error: 39 bytes of body are still expected
fetch-pack: unexpected disconnect while reading sideband packet
fatal: early EOF
fatal: fetch-pack: invalid index-pack output

此前出现的关联报错：

error: rpc failed curl 92 http/2 stream 5 was not closed cleanly: cancel (err 8)

已确认无效的操作 #

• 调整http.postBuffer、core.compression等Git参数
• 使用--depth浅克隆
• 关闭杀毒软件
• 切换至HTTP/1.1协议

针对网络条件无法改善的可行解决方案 #

1. 改用SSH协议克隆 #

HTTP协议在不稳定网络下更容易断开，SSH传输通常更可靠：

# 替换为你的仓库SSH地址
git clone git@github.com:<用户名>/<仓库名>.git

若未配置SSH密钥，需先生成密钥并添加至GitHub账号。

2. 拆分克隆流程，单独处理LFS大文件 #

从配置可见仓库使用Git LFS存储大文件，可先跳过LFS文件的即时拉取，再单独处理：

# 临时关闭LFS自动拉取，仅克隆指针文件
git config --global lfs.smudge false
# 克隆仓库结构
git clone <仓库HTTPS/SSH地址>
cd <仓库目录>
# 恢复LFS配置
git config lfs.smudge true
# 单独拉取LFS大文件，可重复执行直至完成
git lfs pull --progress
# 若历史拉取不全，补充完整提交历史
git fetch --unshallow

3. 进一步调整Git超时与资源限制参数 #

在现有配置基础上，追加以下参数以适配弱网络：

git config --global http.lowSpeedLimit 500
git config --global http.lowSpeedTime 600
git config --global core.bigFileThreshold 100M
git config --global pack.windowMemory 100M
git config --global pack.packSizeLimit 100M
git config --global pack.threads 1

这些参数延长了超时时间、降低了速度触发阈值、限制了打包内存占用，避免因资源或超时导致连接断开。

4. 手动下载压缩包后关联远程仓库 #

若克隆始终失败，可直接下载仓库压缩包后关联远程：

1. 打开GitHub仓库页面，点击「Code」→「Download ZIP」下载压缩包
2. 解压到本地目录后执行以下命令：

git init
git remote add origin <仓库HTTPS/SSH地址>
git fetch
git reset --hard origin/main  # 替换为仓库默认分支名，如master
# 拉取LFS大文件
git lfs pull

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