GitHub克隆或下载项目出现致命错误,长时间下载后文件缺失如何解决?
GitHub克隆/下载报错、速度慢、文件缺失解决方案
- 优先使用浅克隆跳过历史提交拉取,大部分场景下只需要最新代码即可,命令如下:
git clone --depth 1 你的目标仓库地址
如果后续需要完整提交历史,再执行git fetch --unshallow补全即可。 - 针对性拉取指定分支,不需要的分支无需同步:
git clone --depth 1 --branch 目标分支名 你的目标仓库地址 - 检查是否安装Git LFS:如果目标仓库使用Git LFS存储大文件,未安装LFS的情况下拉取只会得到指针文件,会出现实际文件缺失的问题。先完成Git LFS安装后执行
git lfs install,再重新拉取仓库即可。 - 配置Git网络优化:可通过Git配置走本地代理加速访问,配置命令:
git config --global http.proxy 本地代理地址:端口号
如果不需要代理时执行git config --global --unset http.proxy清除配置即可。也可将仓库地址的GitHub域名替换为国内可用的GitHub镜像域名后再拉取,速度提升明显。 - 下载压缩包时选择对应分支的最新版本压缩包,不要下载全量仓库归档包,体积更小下载成功率更高。
出现十几小时下载后文件缺失的核心原因是长链路弱网传输下连接中断、校验失败,若仓库包含LFS大文件也会出现默认拉取不全的问题,上述方案可覆盖90%以上的同类场景。

内容的提问来源于stack exchange,提问作者Ardian Krasniqi
相关产品推荐
相关产品推荐

