模型文件硬塞进 Git，GitHub 直接打回原形：使用Git-LFS管理大文件

发布时间：2025-11-04 19:19:52 来源：创站工坊 作者：IT科技类资讯

最近接手了一个计算机视觉项目，模型代码是文件屎山就不说了，反正我也不看代码，硬塞原形主要就是进G件构建一下 docker 镜像，测试一下部署的直接兼容性，这本来不难。打回大文

但是使用，国内服务器的管理网络环境实在是恶劣，需要配置各种镜像（docker镜像、模型apt镜像、文件pip镜像），硬塞原形这些镜像还各有各的进G件问题，结果就是直接搭配下来一直无法构建成功。

之后我灵机一动，打回大文利用 GitHub Actions 来构建镜像，使用以 GitHub 的服务器网络，所有问题不就迎刃而解了吗？

试了之后果然可以成功构建出镜像

不过中途也踩了一些坑，比如大文件的问题

之前的项目没遇到过大文件，因为我从不把 PyTorch 的模型文件放在代码里跟着提交到 git 里！

能做出这种操作的，多少带点那啥😅

GitHub 文件大小限制：

结果就是:

解决办法就是用 **Git LFS (Large File Storage)**，GitHub 官方提供的专门存储大文件（模型权重、二进制、音频视频）的功能。

不过这个也挺抠门的，GitHub LFS 免费额度只有 1GB 存储 + 1GB 流量，超出需要买额外配额（或者用 HuggingFace/百度网盘/OSS 等托管模型文件）。

如果只是存 .pt 模型，可以考虑把权重放 HuggingFace，然后在 README 里写下载链接。

每个系统都能很容易安装

然后初始化

比如说在本文的场景里，.pt 模型文件很大，可以指定让 LFS 管理

这会在仓库生成一个 .gitattributes 文件，内容大概是

记得把这个 .gitattributes 也提交进 git

之前的提交如果包含了大文件

需要把这些大文件重新提交到 LFS

好在 git-lfs 提供了很方便的命令来清理历史，不然就得用我之前发的那篇文章里的方法来清理大文件了。

之后正常执行推送操作就行了

GitHub 就会把大文件存到 LFS，而不是普通 Git 仓库里。

用了 Git LFS 之后，仓库里保存的源码库大文件（比如 .pt）在普通 git clone 的时候只会看到一个 指针文件（几十字节，记录了真实文件在 LFS 存储里的位置）。

要把大文件本体下载下来，必须要安装过 Git LFS。

所以通常项目 README 里会写一句提示：

这次折腾 GitHub 大文件问题，其实给了我几点启发：

简单一句话总结：学会用 Git LFS，能应急；但别把它当免费网盘用。

另外，再多嘴一句：这个项目看着就像典型的“大学生作业仓库”——代码像屎山，模型直接丢进 git 里，八成还是教授一拍脑袋甩给研究生的“科研成果”。说实话，能跑起来已经算奇迹了 😂。

[1] 如何清理误提交到git的历史大文件？: https://blog.deali.cn/p/clean-git-history-large-files

相关文章