Вы копируете из инструкции npm install, а терминал отвечает npm: command not found (в macOS — zsh: command not found: npm, в Windows — «Имя "npm" не распознано как имя командлета»). Значит, система не нашла программу npm: она либо не установлена, либо лежит в папке, о которой терминал не знает.

npm ставится вместе с Node.js, поэтому почти всегда проблема решается установкой Node.js или правкой переменной PATH. Разберём по шагам для macOS, Linux и Windows.

Коротко
  • npm входит в Node.js: проверьте node -v и npm -v.
  • Если Node.js нет — установите его с nodejs.org, через Homebrew, nvm или менеджер пакетов Linux.
  • После установки закройте и снова откройте терминал, чтобы обновился PATH.
  • В Ubuntu и Debian npm из стандартного репозитория ставится отдельным пакетом: sudo apt install npm.
  • Если вы используете nvm, выберите версию командой nvm use и не запускайте npm через sudo.

Шаг 1. Проверьте, установлен ли Node.js

Выполните в терминале две команды:

node -v
npm -v

Возможны три варианта:

  • Обе команды не найдены — Node.js не установлен или не прописан в PATH. Переходите к установке для своей системы.
  • node работает, а npm нет — типично для Linux, где npm ставится отдельным пакетом, или для повреждённой установки.
  • Обе работают в одном окне, но не в другом (например, в редакторе кода или через sudo) — дело в PATH конкретного окружения, см. раздел «Частые вопросы».

Ошибка zsh: command not found: npm в Терминале и проверка версии Node.js

macOS

Вариант 1. Установщик с сайта

Скачайте LTS-версию (с долгосрочной поддержкой) с официального сайта nodejs.org и запустите pkg-файл. Установщик положит node и npm в /usr/local/bin. После установки закройте и снова откройте Терминал и проверьте npm -v.

Вариант 2. Homebrew

brew install node

Формула node устанавливает и npm. Если ошибка при этом звучит как «command not found: brew», сначала почините Homebrew по нашей инструкции «zsh: command not found: brew».

Вариант 3. nvm (удобно для разработчиков)

nvm (Node Version Manager) позволяет держать несколько версий Node.js и переключаться между ними. Команду установки с актуальным номером версии возьмите из README проекта nvm-sh/nvm на GitHub, затем откройте новое окно терминала и выполните:

nvm install --lts
nvm use --lts
npm -v

Если после установки nvm команда nvm тоже «not found», проверьте, что установщик дописал строки загрузки nvm в ~/.zshrc (для zsh) и что вы открыли новое окно терминала.

Linux

В Ubuntu, Debian и производных npm из стандартного репозитория — отдельный пакет. Поэтому частая ситуация: node есть, а npm нет.

sudo apt update
sudo apt install nodejs npm

В других дистрибутивах:

  • Fedora: sudo dnf install nodejs (npm обычно устанавливается вместе с ним, если нет — sudo dnf install npm);
  • Arch Linux: sudo pacman -S nodejs npm.

Версии в стандартных репозиториях часто старые. Если проекту нужна свежая Node.js, используйте nvm (так же, как в macOS) или официальные репозитории NodeSource — в их пакете nodejs npm уже есть, ставить его отдельно не нужно. Смешивать пакеты из разных источников не стоит: это частая причина конфликтов.

Если в системе нет даже sudo, начните с инструкции «sudo: command not found».

Windows

В Windows ошибка выглядит так: npm : Имя "npm" не распознано как имя командлета, функции, файла сценария или выполняемой программы (в cmd — «"npm" не является внутренней или внешней командой»).

  1. Скачайте установщик LTS-версии с nodejs.org и запустите его. Если установщик предлагает выбрать компоненты, оставьте включёнными «npm package manager» и «Add to PATH».
  2. Закройте все окна терминала, PowerShell и редактора кода — открытые окна не видят новый PATH.
  3. Откройте терминал заново и проверьте node -v и npm -v.

Если Node.js установлен, а ошибка осталась, проверьте PATH вручную: «Пуск» → начните вводить «переменные среды» → «Изменение системных переменных среды» → «Переменные среды». В переменной Path должна быть папка C:\Program Files\nodejs\. Если её нет — добавьте и снова перезапустите терминал.

Ошибка «Имя npm не распознано как имя командлета» в PowerShell и проверка после установки Node.js

Ошибка «выполнение сценариев отключено в этой системе»

Это уже другая проблема: npm найден, но PowerShell не разрешает запускать файл npm.ps1. Разрешите локальные сценарии для своей учётной записи:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Другой вариант — запускать npm.cmd или пользоваться командной строкой cmd вместо PowerShell.

Частые вопросы

npm работает, а sudo npm — «command not found»

sudo запускает команду с собственным, «урезанным» PATH, в котором нет папок nvm. Обычно sudo для npm и не нужен: при установке через nvm глобальные пакеты ставятся в домашнюю папку. Просто выполните команду без sudo.

В терминале npm есть, а в VS Code — нет

Редактор запомнил старый PATH, который был при его запуске. Полностью закройте VS Code (на Mac — ⌘ + Q) и откройте снова. При использовании nvm проверьте, что в новом окне терминала выбрана нужная версия: nvm current.

Ошибка после обновления Node.js через nvm

nvm хранит пакеты отдельно для каждой версии. Задайте версию по умолчанию, чтобы она подхватывалась в каждом новом окне:

nvm alias default lts/*

Глобальные пакеты (например, yarn или pnpm) после смены версии нужно установить заново.

© kak2.ru