Github更新本地仓库到远程总是失败文件过大,如何解决。

环境:

AI-Sphere-Butler

问题描述:

Github更新本地仓库到远程总是失败文件过大,如何解决。

解决方案:

问题核心在于 历史提交中仍然存在未被 LFS 正确追踪的大文件

终极解决方案 (必须按顺序执行)

第一步:修正路径匹配问题
bash 复制代码
# 进入项目根目录后执行
# 删除现有错误的 .gitattributes
rm .gitattributes

# 重建正确的匹配规则(关键:路径必须与仓库实际结构一致)
echo "wav2lip/face_detection/detection/sfd/s3fd.pth filter=lfs diff=lfs merge=lfs -text" > .gitattributes
echo "wav2lip/models/*.pth filter=lfs diff=lfs merge=lfs -text" >> .gitattributes
第二步:彻底清理 Git 历史中的大文件
bash 复制代码
# 安装必要工具
pip install git-filter-repo

# 强制删除所有提交中的 .pth 文件(包括子目录)
git filter-repo --path-glob '*.pth' --invert-paths --force

# 清理残留引用
git reflog expire --expire=now --all
git gc --prune=now --aggressive
第三步:重新关联 LFS 并提交
bash 复制代码
# 确保 LFS 已安装
git lfs install

# 重新标记 LFS 文件
git lfs track "wav2lip/models/*.pth"
git lfs track "wav2lip/face_detection/detection/sfd/s3fd.pth"

# 强制重新添加所有文件
git add --force .
git commit -m "Rebuild repository with LFS tracking"
第四步:强制推送(彻底覆盖远程)
bash 复制代码
# 再次添加远程仓库
git remote add origin https://github.com/latiaoge/AI-Sphere-Butler.git
# 先推送 LFS 对象
git lfs push origin metahuman-stream --all

# 再强制推送代码库
git push origin metahuman-stream --force


关键注意事项

  1. 路径一致性

    • 确保 .gitattributes 中的路径与仓库实际结构完全匹配,如果 wav2lip 是仓库根目录的子目录,则无需添加 metahuman-stream/ 前缀。
  2. 历史清理验证

    bash 复制代码
    # 检查是否已清除历史大文件
    git log --stat | grep .pth

    如果仍有输出,说明清理不彻底,需要调整 git filter-repo 的路径参数。

  3. GitHub 限制

    • 如果单个 LFS 文件超过 GitHub 的 2GB 存储限制,需自行压缩分卷(但当前文件 204MB 未超限)
  4. 备用方案

    bash 复制代码
    # 如果仍失败,尝试重建仓库
    rm -rf .git
    git init
    git lfs install
    git remote add origin https://github.com/latiaoge/AI-Sphere-Butler.git
    # 重新添加文件并提交

通过以上操作,可确保历史提交中不再包含原生大文件引用,Git LFS 配置与路径完全匹配。

相关推荐
C++ 老炮儿的技术栈7 小时前
在 Scintilla 中为 Squirrel 语言设置语法解析器的方法
linux·运维·c++·git·ubuntu·github·visual studio
油泼辣子多加8 小时前
2025年07月25日Github流行趋势
github
OpenTiny社区9 小时前
把 SearchBox 塞进项目,搜索转化率怒涨 400%?
前端·vue.js·github
王小义笔记9 小时前
创建属于自己的github Page主页
github
猫头虎12 小时前
GitHub下载教程:2025年最新详解从GitHub上传、下载文件、子目录与完整项目【图文教程】
git·svn·gitee·开源·github·gitea·gitcode
go546315846513 小时前
在本地环境中运行 ‘dom-distiller‘ GitHub 库的完整指南
人工智能·深度学习·神经网络·算法·矩阵·github
绝无仅有17 小时前
Redis 服务挂掉排查与解决
后端·面试·github
飞询17 小时前
Window 部署 coze-stdio(coze 开发平台)
docker·github·coze
kymjs张涛17 小时前
零一开源|前沿技术周刊 #9
前端框架·开源·github
HelloGitHub17 小时前
《HelloGitHub》第 112 期
开源·github