#Что означает ошибка
Failed to resolve import
Vite не нашёл файл или пакет. Установите зависимость, проверьте путь и перезапустите dev-сервер.
#Причины и признаки
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| Нет пакета | Не установлен импортируемый внешний пакет. | Проверьте package.json и npm ls. |
| Неверный путь | Локальный относительный импорт не существует. | Исправьте регистр и путь к исходнику. |
| Кэш Vite | Остался несогласованный кэш сборки. | После исправления реальной причины перезапустите Vite. |
| Нет расширения | Расширение файла отличается от настроек сборки. | Уточните разрешаемые расширения и путь. |
#Пошаговое решение
- Найдите конкретный импортОткройте файл, указанный Vite после
Failed to resolve import, и скопируйте строкуimport ... from .... Если путь начинается с./или../, проверьте существование файла относительно импортирующего модуля; для имени пакета проверьтеpackage.jsonи установленный пакет. - Исправьте регистр и путьВ VS Code в панели «Проводник» раскройте каталог, сравните буквы в имени файла и импорте. Linux и многие серверы различают
Button.jsxиbutton.jsx; Windows может скрывать такую ошибку. Не исправляйте это удалениемnode_modules, если отсутствует локальный файл. - Проверьте зависимости и алиасыЕсли импортируется внешний пакет, откройте терминал в корне проекта и выполните
npm ls ИМЯ_ПАКЕТА(замените имя на реальное); если его нет, установите зависимость способом, предусмотренным проектом. Для алиаса вроде@/componentsпроверьтеresolve.aliasвvite.configи настройку путей TypeScript, чтобы они указывали на существующую папку. - Перезапустите сервер разработкиОстановите Vite сочетанием Ctrl+C в терминале, затем выполните
npm run dev(или команду из scripts проекта). Откройте указанный локальный URL и проверьте, что модуль загружается без ошибки. Если осталась проблема, приложите строку импорта, дерево файлов и часть конфигурации Vite.
#Если проблема осталась
Если «Vite: Failed to resolve import — does the file exist?» повторяется, сохраните время, состояние подключения и точный текст ошибки. Не меняйте сразу несколько настроек — иначе станет трудно понять, какое действие повлияло на результат.