通过 Git LFS 在 GitHub 上传超过 100M 的文件

GitHub 的服务器在用户上传单个文件超过 100M 的时候会拒绝请求,并且报错:

remote: error: File XX is XX MB; this exceeds GitHub's file size limit of 100.00 MB

当然用户可以通过删除上传文件集合中的大文件来解决这个问题。但是作为程序员肯定是希望自己将完整的代码程序上传到 GitHub 上的,那么可以使用 Git LFS 来实现超过 100M 文件的上传,具体操作如下:

Step1:安装 Git LFS

Git LFS 提供 Mac、Windows、Linus 的环境支持,这里是它的官网GitHub 下载页面。Git LFS 并不大,不同运行环境下的安装包最大的也不超过 4M。

当然,如果你的电脑安装有 Homebrew,那么直接在终端执行 brew install git-lfs ,下载安装一步到位。

Step2:track 文件

Git LFS 提供文件扩展名的跟踪,比如需要传一个 .mp4 的文件,那么在终端执行 git lfs track "xx.mp4"

我当时遇到的问题是我的项目依赖了一个高德地图的库,没有文件扩展名,可以直接跟踪文件位置:

git lfs track "/Users/XXX/Downloads/XcodeProject/BikeDemo/Pods/AMap3DMap/MAMapKit.framework/MAMapKit"

Step3:和平常一样的 push

如果你习惯用命令行 push 到 GitHub,那么如往常一样执行:

git add 'file2Push'
git commit -m 'Add design file' # 添加合并描述
git push 'branch'               # 提交到分支

当然如果你喜欢使用 GitHub 提供的图形化客户端,同样: Github客户端提交