Как читать консоль
Окно Console (Window → General → Console) показывает ошибки, предупреждения и сообщения. Щелчок по строке раскрывает стек вызовов внизу: там указан файл и номер строки. Двойной щелчок открывает скрипт прямо на этой строке.
Правило: чините первую ошибку в списке. Остальные часто оказываются её следствием и исчезают сами.
NullReferenceException
Самая частая ошибка: скрипт обращается к объекту, которого нет. Обычно публичное поле не заполнено в инспекторе, GetComponent не нашёл компонент или объект уже уничтожен. Откройте строку из стека и посмотрите, какая переменная там используется.
Похожая MissingReferenceException значит, что объект был, но его удалили через Destroy, а ссылка осталась.
Чтобы найти пустую переменную быстрее, выведите её в консоль через Debug.Log перед строкой с ошибкой или поставьте точку останова в редакторе кода.
Ошибки компиляции и Safe Mode
Если в скриптах есть ошибки компиляции, Unity не запустит игру: кнопка Play не работает, а при открытии проекта редактор предлагает Safe Mode. В этом режиме можно спокойно исправить код, не загружая сцены.
Типичные причины — опечатка, пропущенная точка с запятой, два класса с одним именем, код под старую версию API или пакет, который обновился и сломал совместимость. Текст ошибки с кодом вроде CS0246 ищется быстрее всего.
Розовые материалы
Розовые или фиолетовые объекты — шейдер не подходит к конвейеру рендеринга. Чаще всего ассет сделан для встроенного рендера, а проект на URP (или наоборот).
В URP есть конвертер материалов: Window → Rendering → Render Pipeline Converter. Для отдельных материалов вручную выберите шейдер Universal Render Pipeline/Lit.
Ещё пять частых проблем
- «Scene couldn't be loaded» — сцена не добавлена в список сборки (Build Profiles или Build Settings)
- персонаж проходит сквозь стены — движение в Update вместо FixedUpdate или нет коллайдера
- клавиши не работают — код под старый Input Manager, а в Player Settings включена только новая Input System
- игра тормозит — GetComponent или Find в Update каждый кадр; кэшируйте ссылки в Start
- кнопки UI не реагируют — нет EventSystem или кнопку перекрывает другой элемент
Проблемы с установкой и входом
Отдельный класс проблем — не открывается Unity Hub, не проходит вход в Unity ID, не активируется лицензия. Из России это случается чаще: Unity приостановила продажи в 2022 году, и часть сервисов работает нестабильно. Об этом подробно — на странице про Unity Hub и на странице «Без VPN».
Если проект перестал открываться после обновления версии, откройте его в прежней версии редактора и сделайте резервную копию перед переходом.
Как не наступать на те же грабли
Держите проект в системе контроля версий — хотя бы локальный Git с правильным файлом .gitignore для Unity. Тогда любую поломку можно откатить к последнему рабочему состоянию, а не восстанавливать по памяти.
Перед обновлением версии Unity или крупного пакета делайте копию проекта. И копируйте код из уроков осознанно: смотрите, под какую версию и систему ввода он написан.
Когда быстрее через ИИ-агента
Вставьте ИИ-агенту LeanTech текст ошибки целиком и сам скрипт — он объяснит причину по-человечески и вернёт исправленный файл .cs. Это быстрее, чем искать похожий вопрос на форумах, где ответ часто под другую версию Unity. Работает без VPN, оплата картой РФ.
Чего агент не делает: не запускает ваш проект, не видит сцену и инспектор, не ставит пакеты и не делает 3D. Если ошибка связана с настройками сцены, приложите скриншот иерархии и инспектора.