Почему в Python возникает ошибка “attempted relative import with no known parent package”?

Question

При организации проекта с несколькими каталогами и модулями в Python не получается использовать относительные импорты. Пробовал через sys.path, но это не помогает, а при попытке относительного импорта возникает ошибка:

ImportError: attempted relative import with no known parent package

или

ModuleNotFoundError

Что делать, чтобы модули из соседних папок корректно импортировались?

```bash
ImportError: attempted relative import with no known parent package
```

или

```bash
ModuleNotFoundError
```

Что делать, чтобы модули из соседних папок корректно импортировались?

Nikolai Gagarinov · Answer

В Python относительные импорты работают только внутри **пакетов**, то есть директорий с файлом `__init__.py`, и когда модуль запускается как часть пакета. Если запустить отдельный скрипт напрямую (`python module.py`), относительные импорты не сработают.

1. **Структура проекта** должна быть пакетной:

```bash
project/
├── package1/
│   ├── **init**.py
│   └── module1.py
├── package2/
│   ├── **init**.py
│   └── module2.py
└── main.py
```

2. **Относительные импорты** пишутся внутри пакетов:

```python
# внутри package2/module2.py
from ..package1.module1 import func
````

3. **Запуск через пакет**:

```bash
python -m package2.module2
```

или запускать скрипт из корня проекта (`project/`) так, чтобы Python видел пакеты.

4. **Избегать изменения `sys.path`** — это считается плохой практикой и может привести к непредсказуемым ошибкам.

Замечание: иногда IDE вроде PyCharm корректно подхватывают пути пакетов, а VS Code нет. Всегда проверяйте запуск из командной строки с правильным рабочим каталогом.

Почему в Python возникает ошибка “attempted relative import with no known parent package”?

Ответы