带有大文件的 GitHub 项目的创建与拉取——使用 Git Large File Storage (LFS)

1.0 简介

GitHub与Gitee等是我们常用的代码托管平台，但GitHub有一个限制，单次上传不能超过100M大小限制。💡想要上传超过100M大小的文件，就需要借助Git LFS。

官方文档

1.1 为当前用户配置 Git LFS

每个用户执行一次即可：

git lfs install

告诉 Git LFS 需要追踪哪些文件。例如，追踪 .tar.gz 格式的压缩文件

git lfs track "*.tar.*"

上一步骤将自动生成 .gitattributes 文件，将其添加到暂存区

git add .gitattributes

向暂存区中添加剩余变更、提交、推送

git add --all
git commit -m "first commit"
git push orgin main

1.2 拉取含有大文件的 GitHub 仓库

直接 clone 即可。若在安装 Git LFS 前执行了 clone，则拉取下来的仓库中并不包含大文件本体，取而代之的是指向其 LFS 存储对象的文件指针，此种情况下，可通过在本地仓库中执行下述命令来 拉取文件指针所指向的完整对象：

git lfs pull

1.3 转换历史数据到LFS

有时候我们的文件已经在repository中了，比如很多历史提交的文件，我们想要将其转换称为LFS存储该怎么办呢？

lfs提供了一个migrate命令，用来进行文件的转存。

git lfs migrate

要想使用migrate命令，需要安装 Git LFS v2.2.1版本以上。

比如我们想要migrate所有的tar.gz文件，可以这样写：

git lfs migrate import --include="*.tar.gz"

上面的命令只针对的是本地的branch，如果要migrate远程的branch，可以添加一个–include-ref参数，如下所示：

git lfs migrate import --include="*.tar.gz" --include-ref=refs/heads/master 

然后强制提交库即可：

git push --force

最后，上面的命令虽然将历史的git objects 转换成了 lfs objects，但是本地的.git文件中并没有变化，所以还需要执行下面的命令对.git文件夹进行清理：

git reflog expire --expire-unreachable=now --all
git gc --prune=now