Ошибка «отсутствует модуль» (в разных программах она звучит как «не удаётся найти указанный модуль», ModuleNotFoundError или «модуль не обнаружен») означает одно: программа при запуске обратилась к файлу или библиотеке, которой нет там, где система её искала. Первое действие — прочитать полный текст ошибки и найти имя конкретного модуля: это либо файл с расширением .dll, .pyd, .so, либо название пакета, например numpy или requests.

Без имени модуля диагностика превращается в гадание. Текст ошибки обычно содержит путь, по которому шёл поиск, и это уже половина ответа: либо файл удалён, либо программа смотрит не в ту папку. Ниже разберём, как определить причину и устранить её безопасными способами — от простых к сложным.

Что скрывается за сообщением об отсутствующем модуле

Термин «модуль» в разных средах означает разное. В Windows это чаще всего динамическая библиотека DLL, которую загружает программа при старте. В Python — пакет или файл .py в путях импорта. В CMS и фреймворках — плагин или расширение, прописанное в конфигурации.

Общий принцип один: в момент запуска загрузчик проходит по списку каталогов и ищет файл с нужным именем. Если поиск завершился неудачей, вы видите сообщение об отсутствии модуля. Важно понимать, что сам файл может существовать на диске — проблема тогда в путях поиска, а не в отсутствии файла как такового.

Типичные ситуации, когда возникает эта ошибка:

  • 🗑️ Удаление программы «вручную» — папку стёрли, а ярлык или служба остались и пытаются запустить несуществующий модуль.
  • 🧹 Чистка антивирусом — защитник отправил DLL в карантин, посчитав её подозрительной.
  • 📦 Неустановленная зависимость — пакет не добавлен в окружение Python или не поставлен вместе с программой.
  • 🔀 Конфликт версий — установлено несколько версий библиотеки, и загружается несовместимая.
  • ✂️ Прерванная установка или обновление — часть файлов скопировалась, часть нет.

Шаг 1. Точно определите, какого модуля не хватает

Откройте полный текст ошибки: в окне программы, в консоли, в журнале событий. В Windows системные ошибки запуска можно посмотреть через Просмотр событий (eventvwr.msc) в разделе «Журналы Windows → Приложение». Там фиксируется имя модуля, который не удалось загрузить.

В Python текст исключения прямо называет пакет: ModuleNotFoundError: No module named 'имя'. Проверьте, не опечатка ли это — регистр букв и дефисы имеют значение: пакет может ставиться как pip install pillow, а импортироваться как import PIL.

💡

Сфотографируйте или скопируйте полный текст ошибки до того, как закроете окно. Имя модуля и путь в сообщении — главная зацепка для диагностики.