Python: ImportError: cannot import name — имени нет в модуле
Модуль нашёлся, а имени, которое программа берёт из него через from … import, в нём нет. Причину подсказывает конец сообщения — текст в скобках.
Содержание 9
Как выглядит ошибка
Traceback (most recent call last):
File "/home/ivan/myapp/app.py", line 1, in <module>
from example_pkg import connect
ImportError: cannot import name 'connect' from 'example_pkg' (/home/ivan/myapp/venv/lib/python3.12/site-packages/example_pkg/__init__.py)В первых кавычках — имя, которое не нашлось, во вторых — модуль, в скобках — файл, из которого Python взял модуль. Если в модуле есть похожее имя, Python допишет подсказку, например Did you mean: 'connect_db'?. Тексты ошибок сверены с исходным кодом Python 3.12.3 — эта версия стоит в Ubuntu 24.04 — и Python 3.14.4 из пакета python3.14 в Ubuntu 26.04.
Если в сообщении No module named — Python не нашёл сам модуль, это другая ошибка: ModuleNotFoundError.
Что значит текст в скобках
| В скобках | Причина | Что сделать |
|---|---|---|
| путь к библиотеке в папке site-packages | в установленной версии библиотеки нет такого имени или в имени опечатка | проверьте версию |
most likely due to a circular import | два файла программы импортируют друг друга, или ваш файл назван как библиотека | разберите импорт |
consider renaming, путь к вашему файлу | ваш файл назван как модуль Python, например email.py, и мешает его загрузить | переименуйте файл |
unknown location | Python взял папку с этим именем без файла __init__.py | найдите папку |
Если в скобках путь к библиотеке
Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне. Команды pip на этой странице вводятся во включённом окружении venv: в начале строки ввода видно (venv). Как его создать и включить — в разделе Виртуальное окружение venv.
Посмотрите, какие имена есть в модуле, — вместо example_pkg подставьте модуль из сообщения:
python -c "import example_pkg; print(dir(example_pkg))"Если нужное имя есть, но написано иначе, исправьте строку import в программе. Если его нет, программа написана под другую версию библиотеки: имя появилось позже или его убрали. Поставьте версии, с которыми программа работала у автора, — их список хранится в файле requirements.txt:
pip install -r requirements.txtЕсли такого файла нет, посмотрите в описании программы, какая версия библиотеки нужна, и поставьте её, например pip install example-pkg==2.1. Установленные версии покажет pip list.
Если в сообщении circular import
Целиком текст такой:
ImportError: cannot import name 'db' from partially initialized module 'models' (most likely due to a circular import) (/home/ivan/myapp/models.py)Это значит, что Python начал загружать models.py, а тот, не загрузившись до конца, сам импортировал файл, которому нужен models. Например app.py берёт db из models.py, а models.py берёт что-то из app.py. Исправить можно так:
| Способ | Что сделать |
|---|---|
| вынести общее в третий файл | перенесите db в отдельный файл, например database.py, и импортируйте его и в app.py, и в models.py |
| импорт внутри функции | перенесите строку import из начала файла внутрь функции, которой он нужен: тогда он выполнится при вызове функции, а не при загрузке файла |
Посмотрите и на путь в конце сообщения. Если там ваш файл с именем библиотеки, например /home/ivan/myapp/requests.py, дело не в цикле — переименуйте файл. В Python 3.14 в таком случае вместо circular import будет подсказка consider renaming.
Если ваш файл назван как модуль
Python ищет модули сначала в папке, где лежит запущенная программа. Если там есть файл email.py, requests.py или telegram.py, Python возьмёт его вместо модуля с тем же именем, и нужного имени в нём не окажется. Python 3.14 пишет об этом прямо:
ImportError: cannot import name 'message_from_string' from 'email' (consider renaming '/home/ivan/myapp/email.py' since it has the same name as the standard library module named 'email' and prevents importing that standard library module)Python 3.12 пишет только путь к файлу в скобках: (/home/ivan/myapp/email.py). Переименуйте свой файл, например в mail_utils.py, и поменяйте строки import, где он упоминается:
mv email.py mail_utils.pyЕсли в скобках unknown location
Python нашёл папку с именем модуля, в которой нет файла __init__.py, и взял её. Откуда она взялась, покажет команда:
python -c "import example_pkg; print(example_pkg.__path__)"Если путь ведёт в папку вашего приложения, например /home/ivan/myapp/example_pkg, переименуйте или уберите эту папку: Python должен брать библиотеку из окружения venv. Если путь ведёт в site-packages, переустановите библиотеку: pip install --force-reinstall example-pkg.
Как проверить
Повторите импорт отдельной командой — вместо example_pkg и connect подставьте свои имена:
python -c "from example_pkg import connect; print('OK')"Если появилось OK, импорт работает. Если приложение работает службой, перезапустите её: sudo systemctl restart myapp. Если приложение запущено как служба systemd, имя службы в примерах — myapp, папка — /home/ivan/myapp. Подставьте свои.
Источники
- Исходный код Python 3.12.3: Python/ceval.c — cannot import name, partially initialized module, unknown location.
- Исходный код Python 3.14.4: Python/ceval.c — подсказка consider renaming.
- Исходный код Python 3.14.4: Objects/moduleobject.c — когда Python считает, что файл мешает загрузить модуль.
- Исходный код Python 3.12.3: Lib/traceback.py — подсказка Did you mean.
- Документация Python: путь поиска модулей — папка программы просматривается первой.
Сверено 22 октября 2026 года.
Что почитать дальше
- ModuleNotFoundError: No module named.
- Виртуальное окружение venv.
- Все ошибки Python и pipтаблица по тексту сообщения.