Эта ситуация встречается чаще, чем хотелось бы, и в 90% случаев дело в неправильно настроенных переменных окружения. В этой статье разберёмся, откуда берётся проблема, почему Windows вообще не видит ваши npm-модули, и как это исправить за несколько минут.

Почему Windows не видит npm и Node.js

Проблема кроется в том, что Windows не знает, где искать исполняемые файлы npm и Node.js. Когда вы вводите команду в командную строку, операционная система ищет соответствующий файл в тех папках, которые указаны в переменной окружения PATH. Если путь к Node.js туда не добавлен, система просто не найдёт нужную программу.

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

Вот основные сценарии, когда npm не работает:

• После установки Node.js путь не добавился в PATH автоматически
• Переменная окружения была удалена или повреждена
• У вас нет прав администратора для добавления переменных окружения
• Командная строка была открыта до внесения изменений в PATH
• Путь указан неправильно или с опечатками

Проверка и добавление PATH в Windows

Прежде чем что-либо менять, стоит проверить, установлен ли вообще Node.js и какой путь к нему используется. Откройте командную строку (cmd) или PowerShell и выполните простую команду:

node --version

Если команда отработала и показала версию вроде v16.15.1, значит Node.js в PATH уже есть. Если выскочила ошибка - переходим к добавлению пути вручную. Узнать, где физически лежат файлы Node.js, можно командой:

npm root -g

Эта команда выведет путь к глобальным пакетам. Сам Node.js обычно находится в C:\Program Files\nodejs (для 64-битных систем) или C:\Program Files (x86)\nodejs (для 32-битных).

Добавление пути в переменные окружения Windows - процесс несложный:

1. Нажмите Win + X и выберите «Система» или перейдите в Панель управления
2. Откройте Система и безопасность - Система - Дополнительные параметры системы
3. В окне свойств найдите кнопку Переменные среды (обычно внизу)
4. В разделе Системные переменные найдите переменную PATH и нажмите Изменить
5. Нажмите Создать и добавьте путь: C:\Program Files\nodejs (или тот путь, где у вас установлен Node.js)
6. Нажмите ОК несколько раз для сохранения
7. Закройте все командные строки и откройте новую - это важно!

После этого введите снова:

node --version
npm --version

Если обе команды выдали версии - поздравляем, PATH настроен правильно!

Когда npm install работает, но команды не запускаются

Бывает странная ситуация: глобально вы установили какой-то пакет, например eslint, но команда eslint --init не срабатывает и выдаёт «команда не найдена». Дело часто в том, что npm вообще не рекомендует устанавливать утилиты глобально уже много лет подряд.

Вместо этого есть два нормальных способа работать с командами. Первый - использовать npx, специальный инструмент, который запускает пакеты без их установки (или устанавливает их во временную папку). Второй - ставить пакеты локально в проект и запускать через npm-скрипты.

Запуск утилит через npx выглядит так:

npx eslint --init

Эта команда скачает нужную версию eslint (если её ещё нет в кеше) и запустит её. Никаких глобальных установок, никаких проблем с PATH для отдельных пакетов. Правда, в поле минусов - первый запуск может быть медленным из-за загрузки пакета, но потом npx кеширует его и работает быстро.

Второй способ - локальная установка:

npm install --save-dev eslint

После этого пакет появится в папке node_modules, а команду можно запустить двумя способами:

npx eslint --init

Ор добавьте скрипт в package.json:

"scripts": {
  "lint": "eslint --init"
}

И запустите:

npm run lint

Сравним оба подхода:

Использование nvm for Windows для нескольких версий Node.js

Если вы работаете над разными проектами, которым нужны разные версии Node.js, глобальная установка одной версии становится неудобной. Для этого существует инструмент nvm for Windows (Node Version Manager), который позволяет быстро переключаться между версиями без переустановки.

Основное преимущество nvm - это возможность работать с несколькими версиями Node.js одновременно, тестировать совместимость кода и не ломать проекты, которые требуют конкретную версию. После установки nvm в PATH добавляется только сам инструмент, а Node.js версии управляются отдельно.

Установка и использование nvm for Windows:

1. Скачайте и установите nvm for Windows (поиск в гугле по «nvm for windows releases»)
2. После установки откройте PowerShell или CMD и выполните:

nvm install 16.15.1
nvm use 16.15.1

3. Проверьте, что версия переключилась:

node --version

Дальше вы можете установить ещё версии и переключаться между ними:

nvm install 18.0.0
nvm list
nvm use 18.0.0

Каманда nvm list покажет все установленные версии, текущая будет отмечена звёздочкой. Это намного удобнее, чем каждый раз переустанавливать Node.js.

Основные команды nvm for Windows:

• nvm install <версия> - установить конкретную версию Node.js
• nvm use <версия> - переключиться на версию
• nvm list - показать все установленные версии
• nvm uninstall <версия> - удалить версию
• nvm current - показать текущую активную версию

Права администратора и корпоративные сети

На корпоративных компьютерах с ограниченными правами может возникнуть проблема: даже если вы установили Node.js, добавить переменную в PATH не удаётся из-за отсутствия прав администратора. В этом случае есть несколько выходов.

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

Если администратор не готов помогать, можно попробовать установить Node.js в папку профиля пользователя, например C:\Users\YourName\NodeJS, а не в Program Files. Затем добавить эту папку в пользовательские переменные окружения (те, что выше системных в окне переменных). Это требует меньше прав и работает только для вас, но лучше, чем вообще ничего.

Третий вариант - использовать для разработки контейнеры Docker или WSL2 (Windows Subsystem for Linux). Внутри контейнера вы получите полный контроль над окружением и не будете привязаны к Windows и его ограничениям. Это более сложное решение, но оно даёт максимальную свободу.

Что делать при проблемах с правами:

• Убедитесь, что вы запустили командную строку от администратора (правый клик - «Запустить от имени администратора»)
• Проверьте, может ли ваша учётная запись редактировать переменные окружения (попросите администратора)
• Если прав нет - используйте пользовательские переменные и установите Node.js в свою папку
• Рассмотрите вариант с WSL2 или Docker для полной независимости

Базовые npm-команды для новых проектов

Когда PATH уже настроен и npm работает, нужно знать базовый набор команд для создания и управления проектами. Это не сложно, но очень важно для понимания, как устроена вся экосистема Node.js.

Создание нового проекта начинается с инициализации. Создайте папку проекта, откройте в ней командную строку и выполните:

npm init -y

Флаг -y пропускает все вопросы и создаёт package.json с параметрами по умолчанию. Если хотите ответить на вопросы вручную (название проекта, версия, описание и т.д.), просто выполните npm init без флага.

После этого в папке появится файл package.json - главный файл проекта, где хранятся метаданные и список зависимостей. Он выглядит примерно так:

{
  "name": "my-node-app",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC"
}

Теперь можете устанавливать пакеты. Локальная установка (в текущий проект):

npm install express

Это скачает пакет express и добавит его в папку node_modules, а также обновит package.json. Для разработки (тестовые фреймворки, сборщики и т.д.) используйте флаг --save-dev:

npm install --save-dev jest

Глобальная установка (доступна везде в системе) - не рекомендуется для большинства пакетов, но иногда нужна для утилит:

npm install -g nodemon

Чтобы посмотреть, какие пакеты установлены в проекте:

npm list

Это покажет дерево зависимостей с глубиной вложения. Для глобальных пакетов:

npm list -g --depth=0

Флаг --depth=0 показывает только то, что вы установили явно, без их зависимостей.

Часто используемые команды npm:

• npm init - создать новый проект
• npm install <package> - установить пакет локально
• npm install --save-dev <package> - установить пакет для разработки
• npm install - установить все пакеты из package.json (нужно в скачанном проекте)
• npm list - показать установленные пакеты
• npm update - обновить все пакеты до последней совместимой версии
• npm run <script> - запустить скрипт из package.json

Что дальше и на что обратить внимание

Когда npm наконец заработал, не забудьте, что это только начало. Экосистема Node.js огромна, и правильная работа с зависимостями - это целая дисциплина. Обязательно изучите, чем отличаются dependencies и devDependencies, как работает package-lock.json и почему он важен для команды.

Также стоит выработать привычку использовать npx вместо глобальных установок - это современный подход, который избавляет от кучи проблем с PATH и конфликтами версий. Если вы работаете в команде, требуйте, чтобы все необходимые инструменты были описаны в package.json, а не устанавливались глобально на каждой машине - это сэкономит часы на отладку проблем в будущем.