Unity долго импортирует проект: что проверить до удаления Library

Unity долго импортирует проект: что проверить до удаления Library

При долгом открытии Unity сначала найдите что импортируется, сколько это занимает и почему происходит повторно. Удаление Library может заставить редактор заново получить восстановимые результаты импорта, но не устраняет автоматически причину медленной обработки. Регулярная очистка способна просто повторять дорогой холодный запуск.

Ниже рассматривается Unity 6.0, ветка 6000.0. Это диагностика работы с ассетами, не инструкция по восстановлению потерянных исходников и не универсальный «ускоритель» любого проекта.

Разделите исходники, метаданные и результаты импорта

В описании Asset Database Unity различает исходный файл ассета и полученный из него artifact. Редактор преобразует исходные данные в форму для работы и выполнения приложения, а Asset Database отслеживает соответствие и зависимости.

Unity пишет, что artifacts можно заново получить из исходных ассетов с сохранёнными настройками импорта и проекта. Это условие, а не обещание восстановления любого случайного файла из удалённой папки. Сторонние инструменты и нестандартный рабочий процесс тоже нужно учитывать.

Сначала сделайте сохранную рабочую точку

Штатно сохраните проект и убедитесь, что у вас есть проверенная копия нужных исходников и настроек. Если используете систему контроля версий, проверьте не только последний коммит, но и незакоммиченные и неотслеживаемые файлы. Не экспериментируйте с единственным экземпляром проекта.

Сделайте диагностическую копию с понятным названием и работайте в ней. Не переносите проект в новую папку одновременным переименованием ассетов без их метаданных. Unity предупреждает: потеря .meta разрывает ссылки, потому что редактор создаёт новый идентификатор.

Перемещение через Project window сохраняет соответствие автоматически. Если файловая операция выполняется вне Unity, исходник и его .meta должны оставаться парой. «Сэкономить место» удалением метаданных — неправильный способ обслуживать проект.

Найдите дорогой импорт в Import Activity

Откройте Window → Analysis → Import Activity. Руководство Unity указывает, что окно показывает недавно импортированные ассеты, длительность и причину обработки.

Начните с Show Overview: оно помогает найти самые долгие импорты и ассеты с большим количеством зависимостей. Затем выберите конкретный объект и посмотрите его историю. Полезные вопросы:

• Это один большой исходник или множество зависимых объектов?
• Повторный импорт идёт после реального изменения или неожиданно при каждом открытии?
• Не изменилась ли целевая платформа?
• Не менялись ли настройки импорта, версия инструмента или зависимости?
• Сколько места доступно в фактическом рабочем каталоге?

Сохраните наблюдения до очистки. История, доступная в окне, не бесконечна: документация описывает связь предыдущих импортов с Library и очисткой неиспользуемых artifacts при перезапуске. Уничтожать данные расследования раньше просмотра неудобно.

Почему смена платформы меняет результат

Unity прямо отмечает, что переход на другую целевую платформу может вызвать повторный импорт: например, форматы текстур для платформ различаются. Результаты для разных платформ хранятся как отдельные кэшированные данные.

Поэтому первый переход на новую платформу и повторное открытие уже подготовленного проекта — разные опыты. Не сравнивайте их как доказательство того, что один ноутбук «вдвое быстрее», если условия не одинаковы.

Если вы переключаетесь между платформами, не удаляйте накопленные результаты после каждой сессии без причины. По документации возврат к ранее импортированной платформе может использовать уже имеющийся кэш. Размер рабочего набора нужно учитывать при планировании диска, а не только размер папки Assets.

Что делать с Library осторожно

Если есть основания подозревать повреждённый локальный кэш, используйте процедуру для своей версии Unity и выполняйте опыт на сохранной копии с закрытым редактором. Не запускайте случайный скрипт, который удаляет несколько каталогов проекта по одному шаблону.

Перед любым сбросом сформулируйте ожидаемый результат: например, один полный импорт должен завершиться, а следующее открытие без изменений не должно снова повторять тот же необъяснимый объём работы. Само временное освобождение места ещё не доказывает исправление причины.

В этой статье намеренно нет команды массового удаления. Нужно подтвердить состав проекта и конкретную неисправность, а не обещать одинаковую безопасность для любого расширения редактора. Если не уверены, что сможете восстановить весь рабочий проект из исходников и настроек, остановитесь до очистки.

Не путайте синхронизируемую папку с системой контроля версий

В Asset Workflow Unity облачное файловое хранение рабочего проекта названо неподдерживаемым процессом: проблемы синхронизации могут повредить проект. Для управления изменениями предлагается version control.

Это не доказательство, что любой долгий импорт вызван вашим облачным диском. Но если проект активно редактируется в автоматически синхронизируемом каталоге, проверьте соответствие рабочего процесса рекомендациям Unity, а не удаляйте Library в бесконечном цикле.

Критерий успешной проверки

На диагностической копии зафиксируйте версию Unity, платформу, набор изменений, длительность определённого импорта и причину из Import Activity. Затем повторите открытие без дополнительных правок и сравните именно тот же сценарий.

Если импорт завершился, но игра медленно выполняется, это уже другая задача: используйте Unity Profiler с разделением Editor и Player. Если рабочий набор не помещается, бюджет памяти и SSD оценивают с учётом всего проекта и кэшей, не по одной папке исходников.

FAQ

Можно восстановить пропавшую сцену из того, что осталось в Library?

Статья этого не обещает. Library не заменяет резервную копию исходного проекта. При потере данных не продолжайте эксперименты с единственной копией.

Чем больше очищаю кэш, тем быстрее работает Unity?

Такого правила нет. Повторное получение artifacts тоже требует времени. Проверяйте причину повторного импорта и сравнивайте одинаковые условия.