使用 Git LFS 管理大文件

你遇到的问题是在向GitHub推送代码时，因为一个名为model.pt的文件大小达到了892.92MB，超过了GitHub默认的100MB文件大小限制，导致推送失败。

解决方案：使用Git LFS管理大文件

Git LFS（Large File Storage）是GitHub官方推荐的用于管理大文件的工具，下面是完整的解决步骤：

1. 安装Git LFS

首先确保你的系统中安装了Git LFS：

# 在macOS上（使用Homebrew）brewinstallgit-lfs# 在Windows上（使用Chocolatey）chocoinstallgit-lfs# 在Linux上（Ubuntu/Debian）sudoapt-getinstallgit-lfs# 安装后初始化Git LFSgitlfsinstall

2. 追踪大文件类型

告诉Git LFS需要管理哪些类型的大文件（这里是.pt模型文件）：

# 追踪所有.pt文件gitlfs track"*.pt"# 如果只想追踪特定文件gitlfs track"ai_core/asr/funasr/model/model.pt"

3. 提交.gitattributes文件

git lfs track会生成/修改.gitattributes文件，需要将其加入版本控制：

gitadd.gitattributes

4. 重新添加并提交大文件

先删除已缓存的大文件，再重新添加：

# 移除已缓存的大文件（不会删除本地文件）gitrm--cached ai_core/asr/funasr/model/model.pt# 重新添加大文件gitaddai_core/asr/funasr/model/model.pt# 提交修改gitcommit -m"Add model.pt with Git LFS"

5. 重新推送代码

gitpush origin main

额外注意事项

1. Git LFS存储空间限制：GitHub免费账户提供1GB的LFS存储空间和1GB的月度带宽，超出后需要升级付费账户。
2. 已提交的大文件清理：如果大文件已经被提交到历史记录中，仅用上述方法可能无效，需要清理历史记录：

   # 安装BFG Repo-Cleaner（需要Java）# 下载地址：https://rtyley.github.io/bfg-repo-cleaner/# 清理历史中的大文件bfg --strip-blobs-bigger-than 100M your-repo.git# 推送清理后的历史gitpush origin main --force

3. 替代方案：如果不想使用Git LFS，可以将大文件上传到云存储（如阿里云OSS、腾讯云COS），然后在代码中保存下载链接。

总结

1. 核心问题是文件大小超过GitHub 100MB限制，需用Git LFS管理大文件。
2. 解决步骤：安装Git LFS → 追踪大文件 → 提交.gitattributes → 重新添加并推送文件。
3. 注意Git LFS的存储空间限制，或考虑使用云存储托管大文件。