You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

无法推送至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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.22 09:56:16