Поиск
Ошибки

Python: ModuleNotFoundError: No module named — модуль не найден

Python не нашёл модуль, который импортирует программа. Либо библиотека не поставлена, либо она стоит в одном окружении, а программа запущена другим Python.

≈ 4 мин чтения2 шага
Содержание 7

Как выглядит ошибка

Traceback (most recent call last):
  File "/home/ivan/myapp/app.py", line 1, in <module>
    import requests
ModuleNotFoundError: No module named 'requests'

В кавычках — имя модуля, который не нашёл Python. Строка с File показывает файл и номер строки, где стоит import. Тексты ошибок сверены с исходным кодом Python 3.12.3 — эта версия стоит в Ubuntu 24.04 — и Python 3.14.4 из пакета python3.14 в Ubuntu 26.04.

Шаг 1. Узнайте, каким Python запущена программа

Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.

Библиотеки, поставленные в окружение venv, видит только Python из этого окружения. Системный Python из /usr/bin их не видит, и наоборот. Как понять, какой Python запускает программу:

Как запускаетеКакой Python работает
python3 app.py, в начале строки ввода нет (venv)системный, /usr/bin/python3
python app.py во включённом окруженииPython из папки venv
служба systemdтот, что указан в строке ExecStart файла службы

Проверить, какой Python откроется по команде, можно так (команда which):

which python3

Во включённом окружении ответ — путь внутри папки venv, например /home/ivan/myapp/venv/bin/python3. Для службы посмотрите строку запуска:

grep ExecStart /etc/systemd/system/myapp.service

Путь после ExecStart= должен начинаться с /home/ivan/myapp/venv/bin/. Если там /usr/bin/python3, служба запускает системный Python и не видит библиотеки окружения. Исправьте путь в файле службы (как создать службу) и выполните sudo systemctl daemon-reload.

Шаг 2. Поставьте библиотеку в окружение

Перейдите в папку приложения, включите окружение и поставьте библиотеку:

cd /home/ivan/myapp
source venv/bin/activate
pip install requests

Если у приложения есть файл requirements.txt, поставьте всё по списку: pip install -r requirements.txt. Если окружения ещё нет — как его создать.

Имя для pip и имя в import могут не совпадать:

В ошибкеЧто ставить через pip
No module named 'yaml'pip install pyyaml
No module named 'PIL'pip install pillow
No module named 'bs4'pip install beautifulsoup4
No module named 'dotenv'pip install python-dotenv
No module named 'cv2'pip install opencv-python-headless (вариант без окон, для сервера)
No module named 'telegram'pip install python-telegram-bot
No module named 'telebot'pip install pyTelegramBotAPI

Если в ошибке имя вашего файла или папки

Когда в кавычках имя модуля из вашего проекта, Python не нашёл этот файл в папках, где он ищет модули. При запуске python3 app.py первой в списке стоит папка, где лежит app.py, при запуске python3 -m имя — текущая папка. Проверьте, что файл есть и имя написано так же, с учётом больших и маленьких букв (команды ls и cd):

ls /home/ivan/myapp

Вариант No module named 'myapp.models'; 'myapp' is not a package значит, что под именем myapp Python нашёл файл myapp.py, а не папку с модулями. Переименуйте файл или папку, чтобы имена не совпадали.

Как проверить

Попросите Python из окружения загрузить модуль:

/home/ivan/myapp/venv/bin/python -c "import requests"

Если команда ничего не вывела, модуль на месте. Перезапустите приложение и посмотрите его состояние:

sudo systemctl restart myapp
sudo systemctl status myapp

В строке Active должно быть active (running). Если приложение запущено как служба systemd, имя службы в примерах — myapp, папка — /home/ivan/myapp. Подставьте свои.

Источники

Сверено 22 октября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше