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 配置与路径完全匹配。

相关推荐
qianmoQ10 分钟前
GitHub 趋势日报 (2025年07月02日)
github
A5资源网4 小时前
cloudflare配合github搭建免费开源影视LibreTV一个独享视频网站 详细教程
github
mortimer4 小时前
从零到一:构建一个 Chatterbox-TTS API 服务
开源·github·ai编程
真智AI5 小时前
利用 Claude Opus 4 自动化 GitHub 工作流:从安装到实战详解
运维·自动化·github
寻月隐君8 小时前
Rust 网络编程实战:用 Tokio 手写一个迷你 TCP 反向代理 (minginx)
后端·rust·github
喜欢吃豆10 小时前
快速手搓一个MCP服务指南(九): FastMCP 服务器组合技术:构建模块化AI应用的终极方案
服务器·人工智能·python·深度学习·大模型·github·fastmcp
油泼辣子多加19 小时前
2025年06月30日Github流行趋势
github
ai小鬼头20 小时前
AIStarter如何快速部署Stable Diffusion?**新手也能轻松上手的AI绘图
前端·后端·github
寻月隐君1 天前
Rust 异步编程实践:从 Tokio 基础到阻塞任务处理模式
后端·rust·github
bingGO549911 天前
github 集成CICD自动化部署
github