git lfs 迁移

GIT LFS (Large File Storage)

虽然git一直不适合管理二进制文件，不过现在 git 也好像默认提供了git lfs 这个专门用来管理大文件的插件。

基本原理简单来说就是使用类似一个文件指针（文本）代替实际的文件存储，git只存储文件指针的变更历史而不是整个二进制文件，并且在使用的时候，自动提供hook，方便在如clone、pull、reset等操作会自动去获取这些文件指针的源二进制文件，同样更新二进制文件commit的时候，git 会自动将源文件转成文件指针进git log，同时源文件上传lfs。所以在用户层面，GIT LFS的使用其实是无感的。

迁移

上面简单介绍了一下GIT LFS，接下来直接将如何迁移，至于为什么直接讲迁移而不是从0开始如何使用LFS。
是因为往往是git仓库用着用着发现，仓库好大、clone好慢，然后才是想着用LFS。

迁移需要我们有仓库的管理员权限，并且将保护分支之类取消保护；
具体LFS迁移主要分为以下几步。

迁移前最好做好备份，并且和团队同事沟通好，毕竟操作涉及-f高危操作，容易背锅。

GIT LFS 服务端配置

部分自建git 服务的话，可能需要服务端配置开启LFS，比如gitlab。

GIT LFS 客户端安装

windows 的git安装包自带了该插件，不需要另外安装，其他平台可自行安装，链接。

在命令行尝试以下命令。

1

git lfs

如果有类似help文档信息输出，就是已经有git lfs客户端了。

迁移本地历史仓库

lfs迁移基本思想：lfs重写本地历史—>force push覆写远端，达到迁移的效果。
所以我们最好将本地仓库与远端同步，并且将所有的远端分支都创建本地分支；
而后cd到自己本地仓库，执行以下下命令，–include里面是glob表达式，自行添加想LFS管理的文件名，–everything代表所有本地分支

1

git lfs migrate import --include="*.bin,*.lib,*.so,*.dll,*.a,*.zip,*.png,*.pdb,*.apk,*.psd,*.exr,*.FBX,*.anim,*.zip,*.mp4,*.tif,*.bnk,*.dll,*.wem,*.pdf,*.docx,*.chm,*.wav,*.akd,*.png,*.ttf,*.jpg,*.asset,*.prefab,*.tga" --everything

重写完本地分支、tag之类的，

我们在这里可以先执行 git lfs ls-files查看有哪些文件被转成了lfs管理，检查是否有遗漏
确认无误，之后就可以推送到远端；
由于lfs的迁移会重写所有的commit，并且修改hash值，因此需要我们需要加上–froce
这步需要取消保护分支（保护分支无法-f）

1

git push --force --all