處理GitHub不容許上傳大於100M文件問題

一樣是記錄一下本身工做遇到的問題，省得下次再遇到了還處處網上查資料解決。

本身的項目的版本控制用的是Git，代碼倉庫在github託管。項目裏用到了百度導航SDK，因爲百度導航SDK有了新版本，因而就更新到了新版本，更新好了以後想把代碼push到github上，結果出錯了，被拒絕，具體信息是：Total 3007 (delta 664), reused 0 (delta 0)
remote: error: GH001: Large files detected.
remote: error: Trace: 7b7de6b9372ee392e0f3961b05ea6f33
remote: error: See http://git.io/iEPt8g for more information.
remote: error: File  XXX/XXX/BaiduNaviSDK/libbaiduNaviSDK.a is 102.68 MB; this exceeds GitHub's file size limit of 100.00 MB
To https://github.com/XXX/XXXX.git。意思是有大文件，更多信息可到http://git.io/iEPt8g查看，文件libbaiduNaviSDK.a的大小超過了GitHub限制的100M大小。想要push，必須把這個文件移除，但是要怎麼移除呢？開始我是想着直接刪除掉libbaiduNaviSDK.a，結果不行，仍是會報上面的錯，因而我又把libbaiduNaviSDK.a放到忽略文件裏，結果仍是不行，仍是說有大文件，報一樣的錯。這下只能老老實實的看官方的解決辦法了，因而就打開http://git.io/iEPt8g老老實實的研究了一番。大意是說爲了便於管理代碼庫和方便合做夥伴們使用，當你push50M以上的文件時github將會警告，當push100M以上文件，就直接拒絕你的push，要想push必須把該文件從本地倉庫和遠程倉庫所有移除掉。這個移除會永久性的從本地git和github裏移除，若是這個文件很重要，要記得作一次備份。下面進入具體操做。若是這個文件是最近一次commit的，而且你尚未push到github，那麼第一步輸入命令 cd /Users/Dora/Desktop/XXX（cd後面的這個路徑要換成你本身項目的路徑），而後第二步輸入命令 git rm --cached /Users/Dora/Desktop/XXX/XXX/libbaiduNaviSDK.a（加下劃線部分是你本身的要移除的文件的路徑），第三步輸入命令 git commit --amend -CHEAD，執行完這步後，這個大文件將會從你的commit記錄裏移除，而且之後commit都將不會再把它commit了，這時候就能夠git push把本地代碼push到github上了。

注意：這裏可能遇到輸入git rm --cached /Users/Dora/Desktop/XXX/XXX/libbaiduNaviSDK.a命令後說找不到你要刪除的文件的問題，出現這個問題的緣由是你要刪除的文件路徑名沒寫對，必定要仔細檢查，確保要刪除的文件的路徑是正確的。

若是作了這幾步你push的時候仍是報和開始的時候同樣的錯，那說明這個文件你不是最近一次commit時添加的，而是在以前commit過不少次了，這就須要把關於這個文件的全部歷史commit記錄所有清除掉，這時候咱們就須要用到一個叫BFG的工具。咱們要到https://rtyley.github.io/bfg-repo-cleaner/#download這個網站去下載並學習如何使用這個工具。首先先得把這個軟件下載下來，雙擊它，若是你的電腦沒有java的SDK，按照提示安裝好，不然BFG將運行不了。好了以後，咱們要cd進BFG文件所在目錄，第一步輸入命令java -jar bfg.jar --no-blob-protection --strip-blobs-bigger-than 50M my-repo.git（紅色部分是你下載下來的文件的名字,藍色部分是你須要移除的文件大小，橙色部分是你本身.git文件的路徑），第二步cd my-repo.git ，第三步 git reflog expire --expire=now --all && git gc --prune=now --aggressive，第四步git push，到此大功告成。你的commit歷史裏全部大於50M的文件的commit所有被清除，這樣你就能夠push到github上了。這裏只是記錄了怎麼處理遇到的問題，若是想要知道原理，則須要好好好去學習學習。

注意：這裏可能遇到輸入命令java -jar bfg.jar --strip-blobs-bigger-than 50M my-repo.git後bfg運行不成功的問題，緣由是java -jar bfg.jar這個命令必需要在bfg.jar所在目錄下運行才行，不然系統將不知道bfg.jar文件在哪裏，因此執行不成功。因此咱們要先cd到bfg.jar所在目錄，而後在執行ava -jar bfg.jar --strip-blobs-bigger-than 50M my-repo.git命令。對於不熟悉命令行的人來講最容易犯這些錯誤了。