- 简介
- LFS和它的安装
- LFS的使用
- 从LFS中删除文件
- 从LFS中拉取代码
- 转换历史数据到LFS
- 总结
简介
github是大家常用的代码管理工具，也被戏称为世界上最大的程序员交友网站，它的每次升级都会影响很多用户。在我的个人github网站上，之前在做JAVA NIO demo的时候上传了一个自制的大文件，最近对这个项目进行了一些修改，但是却上传不上github网站了，查看报错的原因，就是说项目中有一个大文件无法上传，现在github提供了一个叫做Git Large File Storage (LFS)的工具来替换github中的大文件。
那么什么是LFS，我们应该怎么使用LFS呢？一起来看看吧。
LFS和它的安装
LFS的全称是Git Large File Storage,可以将库中的大文件存储在远程服务器比如GitHub.com或者GitHub Enterprise上，在库中保存的是指向这些大文件的链接。
LFS安装起来比较简单，在mac上可以使用下面的brew命令：
brew install git-lfs
安装完毕之后，需要把LFS和你的git账号关联起来：
git lfs install
注意lfs需要git版本>= 1.8.2
接下来我们就可以愉快的使用LFS了。
LFS的使用
为了模拟github上的大文件，我们可以在github上创建一个新的repository,然后执行下面的命令添加对应的内容：
git init .
echo Hello World > README.md
git add README.md
git commit -m "Initial commit"
上面的代码提交到github上肯定没有问题。
为了测试大文件，我们可以使用dd命令创建一个256M的大文件如下：
dd if=/dev/urandom of=test.bin bs=1024 count=262144
在最新版本的github中，这个文件肯定是上传不上去的，那么我们应该怎么使用LFS呢？
lfs提供了下面的help命令：
$ git lfs help
$ git lfs -h
这里我们需要使用的是git lfs track命令如下：
git lfs track '*.bin'
上面的例子我们使用的是通配符来匹配所有以bin结尾的文件。
当然，如果你想匹配上面的test.bin文件，也可以直接这样使用：
git lfs track 'test.bin'
这个命令的目的就是使用lfs来跟踪这些bin文件。你也可以使用track命令来列出所有被lfs的跟踪路径：
git lfs track
Listing tracked paths
*.bin (.gitattributes)
我们可以使用下面的命令来查看lsf具体的跟踪文件：
git lfs ls-files
但是因为你还没有commit上面创建的bin文件，所以这里是看不到的。
这些lfs的trace信息是存储在项目根目录下的.gitattributes中的。
我们需要一并提交这个.gitattributes文件，以便所有checkout这个库的用户都可以知晓这个lfs服务。
当我们把所有的文件都提交之后，再使用git lfs ls-files命令，可以看到类似下面的内容：
d05241dd24b * test.bin
说明这个文件已经添加到了lfs中。
从LFS中删除文件
上面我们讲解了如何将文件添加到LFS中进行跟踪，如果我们不想使用LFS而是使用传统的git来管理文件该怎么办呢？
lfs提供了untrack的命令，它是和track相反的命令如下：
git lfs untrack "*file-type"
在untrack之后，还要记得从git cache中删除这个文件：
git rm --cached "*file-type"
然后重新添加这个文件到git，commit然后提交即可：
git add "*file-type"
git commit -m "restore "*file-type" to git from lfs"
从LFS中拉取代码
从LFS中拉取代码和传统的普通的git拉取代码是一致的，直接使用git clone命令即可：
git clone https://github.com/username/test_repo.git destination_dir
转换历史数据到LFS
有时候我们的文件已经在repository中了，比如很多历史提交的文件，我们想要将其转换称为LFS存储该怎么办呢？
lfs提供了一个migrate命令，用来进行文件的转存。
git lfs migrate
要想使用migrate命令，需要安装 Git LFS v2.2.1版本以上。
比如我们想要migrate所有的bin文件，可以这样写：
git lfs migrate import --include="*.bin"
上面的命令只针对的是本地的branch，如果要migrate远程的branch，可以添加一个--include-ref参数，如下所示：
git lfs migrate import --include="*.bin" --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
总结
如果你没有使用大文件，那么你不会用到lfs，如果你项目中有大文件，那么就参考这篇文章吧。
本文已收录于 http://www.flydean.com/07-git-largefile/
最通俗的解读，最深刻的干货，最简洁的教程，众多你不知道的小技巧等你来发现！
欢迎关注我的公众号:「程序那些事」,懂技术，更懂你！