1.0 简介
GitHub与Gitee等是我们常用的代码托管平台,但GitHub有一个限制,单次上传不能超过100M大小限制。💡想要上传超过100M大小的文件,就需要借助Git LFS。
1.1 为当前用户配置 Git LFS
每个用户执行一次即可:
git lfs install
.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