如何往Github上push超过100M的文件

Problem

当咱们往github上push超过50M的文件时，github会给出警告；而当文件大小超过100M的时候，github会reject。虽然咱们通常不推荐往github上push大文件，但当有些资源文件或大型的数据集确实须要用版本管理起来时，咱们该如何作呢？

Solution

Git LFS (Git Large File Storage )，它的核心思想能够用下图描述：

如上图所示，Git remote server并无真正保存上传的大文件，而是有一个文本指针指向了大文件所存储的位置（github有专门存储大文件的地方，所以你能够不用关心它具体存储的位置），若是你本地没有安装git lfs，却clone了一个使用了git lfs的仓库的话，你会发现有些文件是文本类型，并有相似以下内容：

version https://git-lfs.github.com/sp...
oid sha256:4b99dbe6fe6f646b2026de93481045bbf34f995559db15fce34d192f1f320ef4
size 156154

这些文件就是文本指针。你能够在安装完git lfs后使用git lfs pull命令将大文件真正的pull下来。

How to use

1. 去官网(https://git-lfs.github.com/)... lfs，确认环境变量已经配置好；

2. 打开命令行运行

   git lfs install

   以上命令只需执行一次，使git lfs完成全局的配置。

3. 针对须要track的大文件运行下面的命令:

   #  跟踪单个文件
   git lfs track "<file_name>"  
   
   # 跟踪一类文件，如改为目录的全部以“.zip”结尾的文件
   git lfs track "*.zip"
   
   # 跟踪“dir”文件夹及其全部内容
   git lfs track "dir/**"

   git lfs track命令的 track 规则与.gitignore的规则同样，请参考 https://git-scm.com/docs/giti...。

4. 运行完track命令后所在工程目录会生成.gitattributes文件，里面记录了你所track的文件，你也能够直接编辑该文件来改变track规则。接下来注意，先add并commit.gitattributes文件，按照官网的说法这时再按通常git的操做已经能够push大文件了，可是本人没有试成功，后来参考别人成功的经验是，不只要add和commit该文件，还要先将该文件push上去，而后再对你的大文件进行普通的git操做。固然，在push以前能够先运行git lfs ls-files来查看相应的文件是否track成功。

Supplements

1. Git LFS 的详细命令，能够经过

   $ git lfs help <command>
   $ git lfs <command> -h

   来查看，或是进入https://github.com/git-lfs/gi...打开任意一个你感兴趣的以.ronn为后缀的文件，里面有对该命令的较为详细的描述。

2. 关于Git LFS server的url的问题，能够参考https://github.com/git-lfs/gi...。固然，你也能够本身搭建和配置git lfs server并将其url配置到git lfs的客户端。
3. 官方教程，请参考https://github.com/git-lfs/gi...。