Python: ModuleNotFoundError: No module named — модуль не найден
Python не нашёл модуль, который импортирует программа. Либо библиотека не поставлена, либо она стоит в одном окружении, а программа запущена другим Python.
Содержание 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. Подставьте свои.
Источники
- Исходный код Python 3.12.3: Lib/importlib/_bootstrap.py — тексты No module named и is not a package.
- Исходный код Python 3.14.4: Lib/importlib/_bootstrap.py — те же тексты.
- Документация Python: инициализация sys.path — в каких папках Python ищет модули.
- Документация Python: venv — у окружения свой Python и свои библиотеки.
Сверено 22 октября 2026 года.
Что почитать дальше
- Python, pip и venv на Ubuntu.
- ImportError: cannot import name.
- Как установить Supervisor на Ubuntu.
- Все ошибки Python и pipтаблица по тексту сообщения.
- User= и WorkingDirectory=папка и пользователь службы.