#Что означает ошибка
exceeds GitHub file size limit
GitHub не принимает файлы больше 100 МБ. Используйте Git LFS или удалите файл из истории (git filter-repo).
#Причины и признаки
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| Большой файл | В сообщении push назван файл более 100 МиБ. | Используйте Git LFS при согласованной необходимости. |
| Файл в истории | Файл уже входит в отправляемую историю. | Выполните согласованную перепись истории на копии. |
| Бинарники | Сборочные бинарники попали в репозиторий. | Исключите их из новых коммитов через .gitignore. |
| Данные | Нужно хранить большие данные. | Выберите хранилище артефактов или LFS с учётом квот. |
#Пошаговое решение
- Найдите файл, отклонённый GitHubВ сообщении
remote: error ... file ... is 100.00 MBзапишите путь и размер объекта. GitHub отклоняет обычный push объектов больше 100 МиБ; удаление большого файла из рабочей папки после коммита не удаляет его из отправляемой истории. - Если большой файл ещё не попал в коммитВ корне репозитория выполните
git status, уберите файл из индексаgit restore --staged -- "ПУТЬ"(если он только staged), добавьте правило в.gitignore, когда файл не должен храниться в Git. Проверьтеgit status— другие изменения должны сохраниться. - Если файл уже в коммите — решите, нужна ли перепись историиЕсли файл должен версионироваться, изучите Git LFS и лимиты проекта; миграция старых коммитов меняет идентификаторы. Если файл уже в предыдущих коммитах, для удаления истории используется специализированная процедура
git filter-repoна отдельной копии репозитория, после резервной копии и согласования со всеми участниками. Не выполняйте слепой force-push. - Проверьте новый pushПосле корректного удаления недопустимого объекта из отправляемой истории или согласованного перевода в LFS выполните
git pushв нужную ветку. Если ошибка повторилась, сохраните её полный текст и найдите другой большой объект; очистка кэша Git или увеличение HTTP-буфера не решает лимит GitHub.
#Если не помогло
Перезапись истории меняет хэши коммитов: заранее согласуйте её с командой.
#Если проблема осталась
Если «Git: файл больше 100 МБ — push отклонён GitHub» повторяется, сохраните время, состояние подключения и точный текст ошибки. Не меняйте сразу несколько настроек — иначе станет трудно понять, какое действие повлияло на результат.