Поиск
Ошибки

Python: ImportError: cannot import name — имени нет в модуле

Модуль нашёлся, а имени, которое программа берёт из него через from … import, в нём нет. Причину подсказывает конец сообщения — текст в скобках.

≈ 6 мин чтения
Содержание 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 locationPython взял папку с этим именем без файла __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. Подставьте свои.

Источники

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

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

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