无法推送至Github:远程端意外挂断(UE4大项目上传失败)
解决UE4项目上传GitHub到100%失败的问题
我之前帮好几个做UE4的朋友解决过一模一样的问题——上传进度拉满到100%,结果突然报错连接重置,心态直接炸!别慌,咱们一步步来搞定它:
1. 先给Git“扩容”,调高传输阈值
UE4项目动不动就几十G,Git默认的传输配置根本扛不住这么大的量。打开终端(Windows用Git Bash,Mac/Linux直接开终端),敲这几个命令:
git config --global http.postBuffer 524288000 git config --global http.maxRequestBuffer 100M git config --global core.compression 0 git config --global http.lowSpeedLimit 0 git config --global http.lowSpeedTime 999999
简单说下这些命令的作用:
- 前两个是把传输时的缓存调大,避免因为缓存不够中途断连
- 关闭压缩是因为大文件压缩反而会拖慢速度,还容易出问题
- 最后两个是取消低速超时限制,不会因为临时网速波动就判定传输失败
2. 清理UE4的冗余文件,减小上传体积
UE4自动生成的一堆文件夹其实完全没必要传GitHub,比如Binaries/、Intermediate/、Saved/这些,传上去纯纯浪费空间还拖慢速度。
- 先在项目根目录创建(或者更新)
.gitignore文件,把这些冗余目录加进去:
# Unreal Engine 4 自动生成文件 Binaries/ Intermediate/ Saved/ DerivedDataCache/ # IDE 配置文件(可选) .vs/ *.sln.DotSettings *.suo *.user
- 然后执行命令把已经被Git追踪但应该忽略的文件移除(放心,不会删你本地文件):
git rm -r --cached . git add . git commit -m "更新.gitignore,排除UE4冗余文件"
这一步做完,上传的文件体积会大幅缩水,从根源降低传输失败的概率。
3. 用Git LFS管理大资产文件
UE4的纹理、模型、地图这些都是超大文件,Git原生对大文件的支持烂得一批,GitHub官方专门搞了Git LFS来解决这个问题。
- 先确认有没有装Git LFS,没装的话终端敲
git lfs install就行 - 然后把UE4常见的大文件后缀加入LFS追踪:
git lfs track "*.uasset" git lfs track "*.umap" git lfs track "*.fbx" git lfs track "*.png" git lfs track "*.jpg" git lfs track "*.mp4"
- 最后提交记录追踪规则的
.gitattributes文件:
git add .gitattributes git commit -m "配置Git LFS管理UE4大资产"
之后再重新push,LFS会把大文件单独传输,比原生Git稳定太多了。
4. 实在不行就分段推送
如果项目实在太大,一次性push容易断,那就把提交拆成多次小批量推:
- 先推最近的几个提交,比如先推5个:
git push origin main --depth=5(数字可以自己调,比如先推3个试试) - 等成功之后,再推剩下的所有提交:
git push origin main
每次传输的数据量小了,就不容易触发连接重置的问题。
内容的提问来源于stack exchange,提问作者Spectre Kelevra
相关产品推荐
相关产品推荐

