#Как выглядит неисправность
После git clone вместо большого файла открывается маленький текстовый указатель «version https://git-lfs.github.com/spec/v1» или отсутствуют двоичные ресурсы проекта. Git LFS хранит содержимое отдельно от обычной истории Git.
#Причины и признаки
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| Git LFS не установленКлон скачан обычным Git, но обработчик LFS не выполнялся | git lfs version не распознаётся | Установить LFS и инициализировать обработчик |
| Недоступен сервер объектовНет прав или исчерпан лимит хранения/трафика | git lfs pull выдаёт 403, 404, ошибку сети | Проверить доступ к LFS-хранилищу и тариф |
#Пошаговое устранение
- 1. Проверьте, это ли указатель LFSОткройте проблемный файл текстовым редактором. Если первые строки содержат version https://git-lfs.github.com/spec/v1, oid sha256 и size, это указатель, а не повреждение двоичного файла. Если файл просто отсутствует, проверьте и путь в ветке.
- Дополнительная команда по темеLinux · Терминал (Bash)КомандаИз корня клона; вторая команда должна показать установленную версию или отсутствие утилиты.
git status --shortgit lfs version
- 2. Проверьте установку расширенияВ системе, где выполнялся clone, установите Git LFS из официального пакета вашей ОС и перезапустите терминал. Команда git lfs version должна заработать; не пытайтесь устанавливать неподтверждённые архивы с произвольных сайтов.
- 3. Инициализируйте обработчик именно для своего профиляОткройте терминал в корне репозитория и выполните git lfs install; обычно права администратора не нужны. Убедитесь, что .gitattributes содержит правила LFS для нужного расширения, а git lfs ls-files показывает файлы с идентификаторами.
- Показывает конфигурацию Git LFS и список отслеживаемых объектов; не удаляет данныеLinux · Терминал (Bash)КомандаПоказывает конфигурацию Git LFS и список отслеживаемых объектов; не удаляет данные.
git lfs installgit lfs ls-files
- 4. Скачайте содержимое файловВыполните git lfs pull в клонированной рабочей копии; дождитесь завершения загрузки. Если в выводе ошибка авторизации или ограничения квоты, остановитесь и проверьте права в хостинге — повторение команды без исправления доступа не помогает.
- Загружает объекты в рабочую копию и может расходовать трафик и местоLinux · Терминал (Bash)С осторожностьюЗагружает объекты в рабочую копию и может расходовать трафик и место.
git lfs pullКоманда может изменить состояние системы или её настройки. Проверьте параметры и последствия перед запуском.
- 5. Проверьте файл на дискеПосмотрите размер исходного файла через файловый менеджер: он должен соответствовать ожидаемому двоичному ресурсу, а не нескольким строкам текста. Запустите приложение, которому нужен ресурс; при ошибке посмотрите вывод git lfs logs last, удалив из журналов закрытые сведения.
- Просматривает журнал последней операции; перед отправкой очистите URL и токеныLinux · Терминал (Bash)КомандаПросматривает журнал последней операции; перед отправкой очистите URL и токены.
git lfs logs last
- 6. Если LFS-объект недоступенСверьте remote через git remote -v, убедитесь, что нужная ветка и сервер корректны; спросите у владельца репозитория, был ли объект фактически загружен. Не удаляйте .git/lfs и не заменяйте указатели пустыми файлами.
#Как проверить результат
Успех: git lfs pull завершается без ошибки, проблемный файл стал двоичным нужного размера, сборка или запуск проекта видят ресурс. Если сервер отвечает 403/404, нужен владелец репозитория или администратор хранилища.
#Если проблема осталась
Не повторяйте опасные действия на рабочем окружении. Сравните первоначальный симптом с новым состоянием, сохраните обезличенные сообщения и версии компонентов, проверьте резервную копию; перед изменением общей истории Git или данных/сети Docker обратитесь к ответственному администратору проекта.