Как импортировать модуль, находящийся уровнем выше

При разработке часто возникает необходимость подключить файл или модуль, расположенный в родительской директории. Стандартные относительные пути ../ и ./ имеют ограничения - они не позволяют подняться выше корня проекта или обойти вложенность. Разберём, как правильно организовать импорт модуля из папки уровнем выше в популярных языках и средах.

Почему ../ не всегда работает

Относительные пути ../ поднимаются ровно на один уровень вверх. Если ваш скрипт находится в src/utils/script.js, а нужный модуль - в src/module.js, то ../module.js сработает. Но если модуль лежит в корне проекта, например /module.js, а скрипт - в src/utils/script.js, то ../../module.js уже не подойдёт, так как вы выйдете за пределы проекта. В этом случае помогает настройка алиасов или использование абсолютных путей.

Решение для Node.js (CommonJS и ES-модули)

В Node.js для импорта модуля уровнем выше используйте:

• Абсолютный путь - const module = require('/full/path/to/module'); (не рекомендуется для переносимости).
• Переменная __dirname - const path = require('path'); const module = require(path.join(__dirname, '..', '..', 'module'));
• Настройка package.json - добавьте поле exports или используйте import maps.

Для ES-модулей (ESM) в Node.js 14+ можно задать import maps в package.json:

"imports": { "#module": "./module.js" }

Тогда импорт выглядит так: import module from '#module';.

Решение для Python

В Python импорт модуля из родительской директории выполняется через манипуляции с sys.path:

import sys, os sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))) import my_module

Более правильный способ - превратить папку в пакет, создав в ней файл __init__.py, и использовать относительный импорт: from .. import my_module. Это работает, если скрипт запущен как часть пакета.

Решение для TypeScript (tsconfig.json)

В TypeScript для импорта модуля уровнем выше настройте алиасы путей в tsconfig.json:

"compilerOptions": { "baseUrl": ".", "paths": { "@src/*": ["src/*"] } }

Теперь импорт выглядит так: import { something } from '@src/module';. Это удобно и не зависит от глубины вложенности.

Общие рекомендации

Избегайте длинных цепочек ../../ - это делает код хрупким и нечитаемым. Используйте:

• Алиасы путей (Webpack, Vite, TypeScript).
• Монорепозитории (Lerna, Nx) с явными зависимостями.
• Переменные окружения для указания корня проекта.

Правильная настройка импорта модуля уровня выше ускоряет разработку и упрощает рефакторинг.