Установка 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.js и npm на Windows

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

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

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

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

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

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

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

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

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:

1. Установите nvm: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh)".
2. source ~/.zshrc (или ~/.bash_profile).
3. nvm install node.
4. Альтернатива: brew install node.
5. Добавьте в 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.

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