問題

在日常開發(fā)中，我們經(jīng)常會(huì)遇到這樣的問題：

Remote: File [xxx.exe] size 188.156MB, exceeds quota 100MB
Remote: Please remove the file[s] from history and try again

這是因?yàn)?Gitee/GitHub 等平臺(tái)對(duì)單個(gè)文件大小有限制（一般是 100MB）。一旦提交了超過限制的大文件，push 就會(huì)被拒絕。

本文以我遇到的一個(gè) exe 安裝包 被錯(cuò)誤提交進(jìn) Git 倉庫為例，分享一下完整的解決思路。

一、為什么不能直接刪除文件？

很多同學(xué)第一反應(yīng)是直接刪除項(xiàng)目里的 exe 文件，然后再提交一次。
但是問題在于：

• 大文件已經(jīng)存在于 Git 歷史中
• 即使最新提交刪除了它，push 時(shí)遠(yuǎn)程仍然會(huì)檢測(cè)到它的歷史，依然報(bào)錯(cuò)

所以必須 從歷史中徹底移除 這個(gè)文件。

二、用 git filter-repo 刪除大文件

git filter-repo 是官方推薦的替代工具，比 filter-branch 更快更簡(jiǎn)單。

1. 安裝

pip install git-filter-repo

2. 在干凈倉庫中操作

?? 注意：git filter-repo 會(huì)修改整個(gè)提交歷史。為了安全，最好新克隆一份倉庫來操作：

git clone https://gitee.com/xxx/your-repo.git clean-repo
cd clean-repo

3. 刪除大文件

例如刪除 YoloAndHalcon/MainPro/發(fā)布/屏蔽蓋SetupV1.0.exe：

git filter-repo --path YoloAndHalcon/MainPro/發(fā)布/屏蔽蓋SetupV1.0.exe --invert-paths

這會(huì)把該文件從整個(gè)歷史中移除。

4. 強(qiáng)制推送

git push origin --force

完成后，大文件就不再存在于遠(yuǎn)程倉庫了。

三、如何避免 exe 等大文件被跟蹤？

很多時(shí)候，exe、zip、mp4、訓(xùn)練模型等大文件 根本不應(yīng)該放在 Git 倉庫里。

1. 使用 .gitignore

在項(xiàng)目根目錄添加 .gitignore：

# 忽略編譯生成的二進(jìn)制文件
*.exe
*.dll
*.so
*.dylib

# 忽略壓縮包
*.zip
*.rar
*.7z
*.tar
*.gz

# 忽略大數(shù)據(jù)文件
*.csv
*.json
*.xlsx
*.db

# 忽略圖片和視頻（按需開啟）
*.mp4
*.avi
*.mov
*.jpg
*.png

# 忽略機(jī)器學(xué)習(xí)模型
*.pt
*.onnx
*.h5
*.ckpt
*.pb

提交后，這些文件就不會(huì)再被 Git 跟蹤。

2. 如果必須保存大文件

如果確實(shí)需要（比如模型文件、視頻數(shù)據(jù)），推薦兩種方式：

• Git LFS（適合版本控制大文件，但 Gitee 免費(fèi)版只有 1GB 限額）
• Release 附件 / 網(wǎng)盤 / OSS（不占用 Git 倉庫空間，更加靈活）

四、總結(jié)

1. 遇到 push 報(bào)錯(cuò)提示大文件超 100MB，要用 git filter-repo 從歷史中徹底刪除。
2. 操作步驟：新克隆倉庫 → 執(zhí)行刪除命令 → 強(qiáng)制推送。
3. 平時(shí)要提前配置好 .gitignore，避免 exe、zip、模型文件等被誤提交。
4. 一句話經(jīng)驗(yàn)：源代碼放 Git，大文件放 Release/網(wǎng)盤，二者分開管理，省心省力。

到此這篇關(guān)于Git大文件推送失敗問題及解決方案的文章就介紹到這了,更多相關(guān)Git大文件推送失敗內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論