Будет ли Node использовать локально установленную версию CLI, если также установлена глобальная версия?

Вопрос или проблема

Ответ или решение

При использовании Node.js и его экосистемы, понимание того, как управляются локальные и глобальные зависимости командной строки (CLI), имеет решающее значение для обеспечения корректной работы проектных разработок. Рассмотрим ситуацию, когда у вас установлен глобальный CLI и вы хотите установить другую (возможно, даже несовместимую) версию этого же CLI как зависимость разработки в вашем проекте.

Локальные и глобальные версии CLI

Node.js управляет пакетами через npm (Node Package Manager), который позволяет вам устанавливать пакеты как локально для конкретного проекта, так и глобально для системы. Глобально установленные пакеты доступны через командную строку из любого места вашей операционной системы, в то время как локальные зависимости доступны только в контексте определенной папки проекта.

Приоритеты выполнения

Когда вы запускаете команду, относящуюся к CLI, Node.js проверяет текущую среду выполнения в следующем порядке:

1. Локальные зависимости: Node.js сначала проверяет наличие исполняемого файла в папке node_modules/.bin вашего проекта. Если CLI был установлен как зависимость разработки (например, с использованием npm install --save-dev <package>), то его исполняемый файл будет находиться в этом каталоге.

2. Глобальные зависимости: Если локальная версия не обнаружена, Node.js продолжает поиск в глобальных установках, что включает пути, добавленные в переменные среды вашего операционного окружения (например, PATH).

Пример

Если у вас установлен глобальный пакет CLI, например, eslint, и вы установили локальную версию eslint как зависимость проекта, команда npx eslint . будет использовать версию, установленную локально в вашем проекте. Это связано с тем, что npx автоматически ищет и запускает локальные зависимости из node_modules/.bin перед обращением к глобально установленным версиям.

Заключение

Таким образом, если у вас есть глобальная версия CLI и вы также установили локальную версию в качестве зависимости разработки, Node.js по умолчанию будет использовать локальную версию. Это поведение является полезным, поскольку оно позволяет избежать конфликтов между разными версиями пакетов и гарантирует, что ваш проект будет работать с версией CLI, которая была специально выбрана для него.

В заключение, всегда рекомендуется использовать локальные версии пакетов, чтобы иметь полный контроль над версиями зависимостей в ваших проектах. Это делает ваши приложения более стабильными и предсказуемыми в различных средах выполнения.