По умолчанию GitHub не позволяет загружать файлы, размер которых превышает 100 мегабайт. При попытке загрузить такой файл вы получите ошибку. Чтобы обойти это ограничение, используется специальный механизм — Git LFS (Large File Storage).
🔧 Что такое Git LFS?
Git LFS — это расширение Git, которое позволяет хранить большие файлы (например, видео, архивы, образы) отдельно от основного репозитория. Вместо самих файлов в Git попадают «ссылки», а сами данные хранятся в другом месте, автоматически обрабатываемом GitHub.
✅ Шаг 1: Установка Git LFS
Если Git LFS у вас ещё не установлен, сделайте это:
- Зайдите на https://git-lfs.com/
- Скачайте установщик для своей системы (Windows, macOS, Linux)
- После установки откройте терминал (или командную строку) и выполните:
git lfs install
Эта команда инициализирует Git LFS на вашей системе.
✅ Шаг 2: Настройка отслеживания файлов
Вы должны указать Git, какие типы файлов нужно обрабатывать через LFS. Например, если вы хотите загрузить .zip-архив:
git lfs track "*.zip"
Это создаст (или обновит) файл .gitattributes, в котором будет записана информация о файлах, отслеживаемых LFS.
⚠️ Обязательно добавьте
.gitattributesв коммит — иначе LFS не будет работать!
✅ Шаг 3: Работа с GitHub Desktop
- Добавьте большой файл в локальную папку вашего репозитория.
- Откройте GitHub Desktop — программа отследит добавление файла и
.gitattributes. - Введите сообщение коммита (например, «Добавлен файл через Git LFS») и нажмите Commit to main.
- Нажмите Push origin для отправки изменений в репозиторий.
ℹ️ Важно помнить
- GitHub предоставляет 1 ГБ хранилища и 1 ГБ трафика в месяц для Git LFS бесплатно.
- Если вы превышаете лимит — GitHub предложит платные тарифы.
- Ограничение в 100 МБ по-прежнему действует для обычных файлов, не отслеживаемых через LFS.
📌 Пример .gitattributes
Вот как может выглядеть файл .gitattributes, созданный при трекинге ZIP-файлов:
*.zip filter=lfs diff=lfs merge=lfs -text
✅ Результат
После этих шагов ваш файл более 100 МБ успешно загружен в GitHub через GitHub Desktop с использованием Git LFS, без ошибок или ограничений со стороны платформы.
