npm: command not found — как установить Node.js и npm на Windows, Linux, macOS

kirilljsx

Ошибка npm: command not found знакома всем, кто только начинает работать с Node.js. Она возникает, когда система не может найти исполняемый файл npm в PATH. Эта статья разберёт причины и покажет, как установить Node.js с npm правильно на любой ОС.

Установка Node.js решит проблему раз и навсегда. Вы сможете запускать npm install, управлять пакетами и разрабатывать проекты без лишних хлопот. Пройдёмся по шагам для Windows, Linux и macOS с проверенными командами.

Почему возникает ошибка npm: command not found

Ошибка npm: command not found значит, что терминал не видит npm в путях поиска исполняемых файлов. Чаще всего это происходит из-за отсутствия установки Node.js, неправильного PATH или конфликта версий. Например, вы скачали Node.js, но забыли добавить путь в переменные среды — и вот, node -v работает, а npm -v выдаёт ошибку.

Другая частая причина — несколько установок Node.js на системе. Они конфликтуют, и npm “теряется”. Или просто нет прав доступа на Linux/macOS. В реальных проектах это тормозит: нельзя установить зависимости, запустить сервер или собрать фронтенд. Давайте разберём диагностику и перейдём к решениям.

Сначала проверьте, установлен ли Node.js:

Запустите node -v в терминале.
Если версия показана — Node.js есть, проблема в PATH или npm.
Нет версии — устанавливаем с нуля.

Таблица распространённых причин ошибки:

Причина	Симптомы	Быстрое решение
Нет установки	`node -v` тоже не работает	Скачать с nodejs.org
Неправильный PATH	`node -v` работает, npm — нет	Добавить путь в переменные
Конфликт версий	Старые node_modules	Удалить старые установки
Нет прав	`permission denied` на Linux	Использовать sudo или nvm

Установка Node.js и npm на Windows

На Windows ошибка чаще всего из-за переменных среды. Node.js ставится в C:\Program Files\nodejs\, но PATH не обновляется автоматически. Вы вводите npm install, а система ищет в дефолтных папках и не находит. Даже после перезагрузки cmd может не видеть npm.

Решение простое: скачайте установщик с официального сайта nodejs.org, выберите LTS-версию и отметьте галочку “Add to PATH”. После установки перезапустите терминал. Если не помогло, вручную добавьте путь в системные переменные.

Шаги по установке и настройке:

Скачайте MSI-файл Node.js LTS с nodejs.org.
Запустите установщик, следуйте инструкциям (галочка PATH обязательна).
Проверьте: node -v и npm -v.
Если npm не найден — добавьте C:\Program Files\nodejs в PATH:
- Win + R → sysdm.cpl → “Дополнительно” → “Переменные среды”.
- В “Path” добавьте путь к nodejs.
Перезапустите cmd или PowerShell.

Если используетеChocolatey: choco install nodejs — автоматически настроит PATH.

Установка на Linux: Ubuntu, Arch и другие дистрибутивы

В Linux npm может отсутствовать, даже если Node.js установлен — в некоторых репозиториях они разделены. На Ubuntu после apt install nodejs npm нет, выдаёт command not found. Плюс проблемы с правами: глобальная установка пакетов требует sudo, что засоряет систему.

Лучший способ — Node Version Manager (nvm). Он ставит Node.js в домашнюю папку без sudo, переключает версии и автоматически добавляет npm в PATH. Для Ubuntu/Debian подойдёт sudo apt install nodejs npm, но версии старые.

Варианты установки на Linux:

Через nvm (рекомендую):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm use --lts

Ubuntu/Debian: sudo apt update && sudo apt install nodejs npm.
Arch Linux: sudo pacman -S nodejs npm (npm отдельный пакет!).
Проверьте PATH: echo $PATH | grep node.
Фикс прав: sudo chown -R $USER:$(id -gn) ~/.npm.

Сравнение менеджеров версий:

Менеджер	Плюсы	Минусы
nvm	Легко менять версии, без sudo	Требует shell-реконфиг
n	Простой, как nvm	Меньше фич
Snap	Универсальный	Медленный старт

macOS: Homebrew, nvm или pkg

На macOS после обновления или чистой установки npm может пропасть из-за M1/M2 чипов или конфликта с системным Node.js. npm: command not found выскакивает в Terminal.app или iTerm. Homebrew ставит в /usr/local/bin, но PATH для новых юзеров иногда пустой.

Используйте nvm — универсально для Intel и Apple Silicon. Или brew install node — быстро, но версии отстают. После установки всегда проверяйте which npm.

Шаги для macOS:

Установите nvm: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh)".
source ~/.zshrc (или ~/.bash_profile).
nvm install node.
Альтернатива: brew install node.
Добавьте в PATH: export PATH="/usr/local/bin:$PATH" в ~/.zshrc.

Для Rosetta на M1: arch -x86_64 /bin/bash перед установкой.

Когда простая установка не помогает

Иногда ошибка упорная: переустановка не спасает. Это конфликты в node_modules, кэш npm или несколько версий Node.js. На Windows удалите папку nodejs полностью, почистите реестр. В Linux проверьте dpkg -l | grep node и удалите всё.

Дополнительные фиксы:

Очистите кэш: npm cache clean --force.
Симлинк на Linux: sudo ln -s $(which npm) /usr/local/bin/npm.
Переустановите через официальный pkg: node --version после.
Для WSL: Убедитесь, что Windows Node.js не мешает.

Что ещё проверить:

Версия shell: zsh/bash видят PATH по-разному.
Корпоративный прокси блокирует npm.

npm заработает в любой ситуации

Теперь вы знаете, как диагностировать и исправить npm: command not found на любой платформе. Главное — правильный PATH, свежая LTS-версия и nvm для гибкости. Осталось разобраться с yarn/pnpm как альтернативами или глобальными пакетами без sudo.

Подумайте о версионном менеджере заранее — сэкономит часы в будущем. В больших проектах это норма, а не опция.