Сборка проектов LinuxWindowsmacOS

Vite: Failed to resolve import — does the file exist?

  • Обновлено
  • Чтение ≈ 1 минута

Краткий ответ

Vite не нашёл файл или пакет. Установите зависимость, проверьте путь и перезапустите dev-сервер.

В этой статье
  1. Что означает ошибка
  2. Причины и признаки
  3. Пошаговое решение
  4. Если проблема осталась

#Что означает ошибка

Сообщение
Failed to resolve import

Vite не нашёл файл или пакет. Установите зависимость, проверьте путь и перезапустите dev-сервер.

#Причины и признаки

Возможная причинаКак узнатьЧто делать
Нет пакетаНе установлен импортируемый внешний пакет.Проверьте package.json и npm ls.
Неверный путьЛокальный относительный импорт не существует.Исправьте регистр и путь к исходнику.
Кэш ViteОстался несогласованный кэш сборки.После исправления реальной причины перезапустите Vite.
Нет расширенияРасширение файла отличается от настроек сборки.Уточните разрешаемые расширения и путь.

#Пошаговое решение

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

#Если проблема осталась

Если «Vite: Failed to resolve import — does the file exist?» повторяется, сохраните время, состояние подключения и точный текст ошибки. Не меняйте сразу несколько настроек — иначе станет трудно понять, какое действие повлияло на результат.

Так эту ошибку тоже называют

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.