Восстановление SerializeReference
Ссылки, потерянные после переименования классов, находятся по всему проекту и восстанавливаются группами.
Быстрый старт
Какой способ выбрать
| Где исправлять | Что сохраняется | Отмена |
|---|---|---|
| Fix в инспекторе ассета | Данные записи в файле | Нет |
| Fix в сцене или Prefab Mode | Только простые поля верхнего уровня | Undo до сохранения |
| Asset References | Данные записи в файле | Нет |
| Project References | Данные записей группы в файлах | Кнопка Undo в сводке перезаписи |
Project References также восстанавливает имена, которые хранят поля SerializableType и SerializableMonoScript, см. Имена типов. Как замечать новые поломки в редакторе, перед сборкой и в CI, описано на странице Проверка перед сборкой и CI.
Fix в инспекторе
После переименования, переноса или удаления класса у поля появляется Missing type, а данные остаются в ассете.


| Действие | Что делает |
|---|---|
| Fix | Открывает выбор класса, включая скрытые через Hidden |
| → Pistol | Назначает предложенный класс; причину показывает подсказка |
В сцене и Prefab Mode Fix возвращает только простые поля верхнего уровня: вложенные объекты, массивы, списки, векторы, цвета и ссылки на объекты получают значения по умолчанию.
Когда Fix нет
| Случай | Что делать |
|---|---|
| Выбрано несколько объектов | Выберите один: до этого Missing type не показывается |
| В сцене или Prefab Mode есть несохранённые изменения | Сохраните: до этого поле показывает <None> без Missing type |
| После несохранённых правок списка не понять, какой элемент стоит в слоте: например, удалён один из двух соседних потерянных элементов | Сохраните: до этого слот показывает <None> без Missing type |
| Экземпляр префаба, класс хранится в исходном префабе | Исправьте исходный префаб, его имя в подсказке |
| Экземпляр префаба, класс задан override | Выберите новый класс на экземпляре или отмените override |
Потерянные элементы в списках
Сохранение, которое меняет размер списка, а у префаба любое сохранение, записывает потерянные элементы списка как <None> и удаляет их данные. FastTools возвращает их сразу после сохранения. Остальные элементы он сопоставляет по rid, поэтому если вы переместили, удалили, продублировали или добавили элемент, потерянный элемент встаёт между прежними соседями. Восстановленные элементы перечисляются в Console.
| Случай | Что происходит |
|---|---|
Вы выбрали для потерянного элемента <None>, другой класс или вставили поверх него | Элемент остаётся заменённым, в том числе после перезагрузки скриптов. После Edit → Undo этого выбора следующее сохранение элемент не теряет |
Вы удалили элемент, стоявший среди других потерянных или <None>-элементов | По сохранённому файлу не понять, какой именно удалён: <None>-элементы и первые потерянные остаются. Console предупреждает о невосстановленном элементе, называет его индекс и rid, чтобы вы могли взять его из системы контроля версий |
| Между двумя сохранениями вы несколько раз правите список | Данные возвращаются, но в наиболее вероятный слот, а он не всегда исходный. Console называет слот каждого восстановленного элемента, а самые неуверенные помечает как slot guessed |
| Списки внутри другой ссылки или вложенного класса, загруженные сцены, Prefab Mode | Не защищаются |
Project References: восстановить группу
Откройте Tools → Aspid 🐍 → FastTools → Project References; Asset References — соседняя вкладка того же окна. Scan Project читает файлы .prefab, .asset, .unity, .controller и .playable под Assets/, кроме Excluded scan folders. Каждый проход показывает индикатор прогресса; Cancel останавливает проверку и оставляет прежние результаты. Группа показывает первые 200 записей, а Show more добавляет следующие 200.


Действия с группой
| Группа | Кнопка в заголовке | Строка под заголовком |
|---|---|---|
| Потерянный тип | Fix all ▼ — выбрать класс для всех записей | Smart Fix → Game.Weapons.Pistol — применить предложенный класс; причина в подсказке |
Переименование с [MovedFrom] | Reassign all ▼ — выбрать другой класс вместо нового имени | Migrate all → Game.Weapons.Crossbow — записать новое имя, см. Миграции |
Подписи кнопок Fix all, Reassign all, Migrate all содержат число записей группы: Fix all (4) ▼, Migrate all (4) → Game.Weapons.Crossbow.
Каждое действие спрашивает подтверждение Rewrite. <None> в выборе класса очищает ссылки группы и удаляет их данные, включая поля с тем же rid; он спрашивает Clear и Undo не имеет. В открытых и несохранённых файлах он очищает ссылки в памяти, до сохранения.
Что сохраняется при восстановлении
Восстановление переписывает только класс, пространство имён и сборку записи; её данные и rid остаются.
Если поля группы разных типов, выбранный класс может подойти не всем: несовместимые записи станут null при переимпорте.
В сводке перезаписи есть Undo: он возвращает прежний класс записям, в которых всё ещё стоит новый. Undo пропадает после Rescan, закрытия окна и перезагрузки домена; Edit → Undo перезапись не отменяет.
Экземпляры префабов
Потерянный класс, заданный через override экземпляра префаба, — в варианте, вложенном префабе или экземпляре в сцене, — показывается в отдельном разделе Prefab instance overrides.


Fix all, Smart Fix, Migrate all и <None> такие записи не переписывают: выберите новый класс на экземпляре в инспекторе или отмените override. В Asset References ссылки, которые есть только в override, не видны.
Имена типов
Поле SerializableType или SerializableMonoScript, чьё сохранённое имя больше не находится, попадает в группу с пометкой type name. Группа объединяет одно сохранённое имя и перечисляет его поля по ассету и пути поля.
| Действие | Что делает |
|---|---|
| Fix all ▼ | Открывает выбор типа с ограничением полей и записывает выбранный тип во все поля группы |
| Smart Fix → Game.Combat.Spear | Записывает единственный подходящий тип с тем же именем класса |
Поле SerializableMonoScript получает ещё и скрипт выбранного типа. Override экземпляра префаба тоже переписывается, потому что хранит имя как обычное значение.
Строки с [TypeSelector] сканирование не находит: восстановите их в инспекторе или кнопкой Change ▼ в Asset References.
Asset References: разобрать один ассет
Откройте Tools → Aspid 🐍 → FastTools → Asset References и укажите сохранённый префаб, ScriptableObject или сцену в поле рядом с Rescan. Либо выберите ассет в окне Project и вызовите Assets → Aspid 🐍 → FastTools → Asset References в главном или контекстном меню, либо нажмите Alt+Shift+R (Option+Shift+R на macOS): вкладка откроется на этом ассете. Щелчок по строке записи в Project References открывает её ассет здесь же.


| Обозначение | Значение |
|---|---|
| Полоса с Fix Missing ▼ | Сохранённый класс не найден; кнопка открывает выбор класса |
| Строка Smart Fix → Game.Weapons.Pistol | Класс, подобранный как у Smart Fix в Project References |
| Строка Migrate → Game.Weapons.Crossbow под полосой Fix ▼ | Класс переименован с [MovedFrom]: строка записывает новое имя, Fix ▼ выбирает другой класс |
| Полоса с Change ▼, Assign ▼ или Assign Required ▼ | Меняет класс исправной ссылки, заполняет пустое или обязательное поле; ассет сохраняется сразу |
| ● shared | Несколько полей указывают на один экземпляр; точки одного цвета отмечают связанные поля |
| type name в подписи карточки | Поле [TypeSelector]-строки, SerializableType или SerializableMonoScript; оно показано, задан в нём тип или нет |
| children on another card в подписи карточки | Дочерние ссылки этой ссылки нарисованы один раз, под её первой карточкой, которая не стоит под потерянным типом; эта карточка — другое поле, которое указывает на ту же ссылку |
| Строка с именем поля и Assign ▼ | Необязательное поле без ссылки или типа, на своём месте среди полей; пустое поле с [Required] остаётся янтарной карточкой |
| Раздел Orphaned | Записи, на которые не указывает ни одно поле; Clear в шапке карточки удаляет запись из файла после подтверждения, без Undo |
| Заголовок с ▼ | Объект, чьи поля показаны в карточках ниже, например Player › Loadout; щелчок сворачивает его карточки |
| Unsaved changes с кнопкой Save Asset | В ассете есть несохранённые правки, а карта читает сохранённый файл: кнопка сохраняет ассет и строит карту заново |
Fix Missing, Smart Fix и Migrate записывают класс в файл сразу, и Edit → Undo его не отменяет.


Миграции с MovedFrom
Если CrossbowLauncher переименован в Crossbow с [MovedFrom], Unity загружает старые ссылки сам. Migrate all записывает новое имя в файлы, чтобы атрибут можно было удалить:
| В файле — до Migrate all | После |
|---|---|
type: {class: CrossbowLauncher, …} | type: {class: Crossbow, …} |
Группа становится ожидающей миграцией, только если старое имя указано в [MovedFrom] ровно у одного класса, этот класс подходит полю, а сохранённый класс — не закрытый generic.
Удаляйте [MovedFrom], только когда старое имя не осталось ни в одном файле. Migrate all не переписывает его:
- в override экземпляров префабов;
- в папках из Excluded scan folders и в файлах вне
Assets/; - в файлах из таблицы ограничений.
Ограничения
| Где | Ограничение |
|---|---|
| Открытые сцены, Prefab Mode, несохранённые и заблокированные файлы | Fix all, Smart Fix и Migrate all их пропускают: сохраните и закройте файл или используйте Fix в инспекторе с ограничениями переноса данных |
| Сцены и поля под потерянной родительской ссылкой | Asset References меняет только потерянные типы; в сцене показывает только пустые обязательные имена типов |
| Двоичные ассеты и нескачанные файлы Git LFS | Не сканируются: Scan Project считает их, Console перечисляет, Asset References показывает Not scanned; используйте Force Text и скачайте файлы LFS |
| Файлы, последний раз сохранённые до Unity 2021.2 | Их managed-ссылки не читаются: пересохраните файлы в текущей версии Unity |
| Больше 1000 карточек ссылок в одном окне | Asset References рисует первые 1000 и сообщает, сколько пропустил; Project References исправляет потерянные типы без этого предела |