使用 git push 推送檔案到 Github 上時，被告知檔案太大無法推送！？馬上教你怎麼解決！
報錯#
當你嘗試使用 git push 推送超過100 MB的檔案時，沒意外就會收到這樣的錯誤。
這是因為 Github 一個檔案最大上傳限制就是100 MB。(ps. 分開上傳可以，但不能同個檔案 100 MB)
1$ remote: error: GH001: Large files detected.
2$ remote: error: Trace: xxxxxxxxxxxxxxxxxxxx
3$ remote: error: See http://git.io/iEPt8g for more information.
4$ remote: error: File xxxxxxxxxxxxx is 101.00 MB; this exceeds GitHub's file size limit of 100 MB
安裝 Git-LFS 解決！#
為此 Github 也提供解決方法 - 「Large File Storage」。
Debian and Ubuntu#
1curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash
2sudo apt-get install git-lfs
3git lfs install
Mac OSX#
1brew update
2brew install git-lfs
3git lfs install
RHEL/CentOS#
Step.1 安裝 git >= 1.8.2#
如果你的版本是 RHEL/CentOS
5或7(而不是6)的話：
a. 可以按這裡安裝 (如果是 CentOS 那麼你只需要執行sudo yum install epel-release)
b.sudo yum install git
如果你的版本是 RHEL/CentOS
6
a.curl -s https://setup.ius.io/ | sudo bash
b.sudo yum install git2u如果你想，你也可以自己建構原始碼。您將需要手動下載 Git-lfs rpm 並進行安裝
rpm -i --nodeps git-lfs*.rpm。
Step.2 安裝 git-lfs#
1curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.rpm.sh | sudo bash
2sudo yum install git-lfs
3git lfs install
Windows#
Step.1 下載安裝檔#
可以從 https://github.com/git-lfs/git-lfs/releases 選擇你要的版本進行下載。
Step.2 執行安裝檔#
Step.3 在 CMD 或者 Git-Bash 執行 git lfs install#
開始使用#
在下 git 指令時，你只需要將追蹤大檔案(超過 100 MB)的指令
git add改成git lfs track。
舉例來說，如果要追蹤副檔名為.psd的大檔案，那請使用
1git lfs track "*.psd"
而不是
git add "*.psd"！
並且確保檔案.gitattributes有被追蹤。 (這是用來告知 github 此為大型檔案的文件)1git add .gitattributes
之後的指令照舊， git add > git commit > git push ！
回到 Github Repository 就可以發現成功被推送了。
如何取消 LFS ？#
- 刪除單個檔案
如果你是要刪除單個檔案，那麼就需要麻煩點到「.gitattributes」這個檔案中去刪除單筆資料，使 Github 知道該檔案不用再被 LFS 給追蹤。 - 移除全部 (不使用 LFS 了)
你需要使用指令「git lfs uninstall」，如果你是較舊的版本則是使用指令「git lfs uninit」來刪除該 Repository 中的 LFS 。
另外也請確保檔案「.gitattributes」不再被追蹤。(建議如果不需要，請直接下git rm .gitattributes刪除它)
範例:
1git lfs uninstall
2git rm .gitattributes
3git add .
4git commit "Uninstall LFS"
5git push origin main
參考資料#
- 《Git Large File Storage》https://git-lfs.github.com/
- 《Cover Image》https://git-lfs.github.com/images/graphic.gif
