Node не является внутренней или внешней командой: как исправить ошибку

Ошибка "node" не является внутренней или внешней командой, исполняемой программой или пакетным файлом появляется в командной строке Windows, когда система не может найти исполняемый файл node.exe — либо Node.js вообще не установлен, либо путь к нему отсутствует в переменной окружения PATH. Чаще всего с этим сталкиваются после первой попытки запустить node -v или npm install в свежеустановленной системе.

Хорошая новость: проблема решается за несколько минут и не требует переустановки Windows. Ниже разберём, как проверить, установлен ли Node.js, почему терминал его «не видит» и что делать в каждом конкретном случае — от простого перезапуска консоли до ручного редактирования переменных среды.

Почему Windows не находит команду node

Когда вы вводите команду в cmd или PowerShell, система ищет исполняемый файл в текущей папке, а затем — во всех каталогах, перечисленных в переменной PATH. Если node.exe нет ни в одном из них, Windows выдаёт именно эту ошибку. Сам по себе текст сообщения не говорит о поломке — это лишь сигнал, что файл не найден по известным системе путям.

Возможные причины обычно сводятся к нескольким типовым сценариям:

  • 🔹 Node.js не установлен — самый частый вариант, особенно на новом компьютере или после переустановки Windows.
  • 🔹 Путь не добавлен в PATH — установщик не прописал каталог в переменные среды (например, была снята галочка при установке).
  • 🔹 Терминал открыт до установки — уже запущенная консоль не подхватывает обновлённые переменные среды.
  • 🔹 Конфликт версий или остатки старой установки — в PATH указывает на папку, из которой Node.js был удалён.
⚠️ Внимание: если вы устанавливали Node.js только что, а консоль была открыта до этого — сначала полностью закройте и заново откройте терминал. В большинстве таких случаев ошибка исчезает без каких-либо дополнительных действий.

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

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

node -v

npm -v

Если обе команды возвращают номера версий — Node.js работает, а проблема была только в устаревшем сеансе терминала. Если снова появляется ошибка, проверьте наличие папки установки. По умолчанию установщик размещает файлы в каталоге C:\Program Files\nodejs. Откройте его в Проводнике и убедитесь, что внутри есть файл node.exe.

Дополнительно посмотреть список установленных программ можно через Параметры → Приложения → Установленные приложения и поиск по слову «Node». Если записи нет и папки тоже — переходите к разделу про установку.

📊 Что показала проверка node -v?
Node.js не установлен
Ошибка осталась, но папка nodejs есть
Ошибка только в VS Code
Всё заработало после перезапуска терминала

Шаг 2. Устанавливаем Node.js правильно

Если Node.js на компьютере нет, скачайте установщик с официального сайта nodejs.org. Для большинства пользователей подходит версия LTS (Long Term Support) — она стабильнее и лучше совместима с популярными пакетами. Актуальный номер версии указан на странице загрузки, выбирайте предложенный по умолчанию вариант для Windows.

Во время установки обратите внимание на экран с параметрами: там есть опция Add to PATH. Она включена по умолчанию — не снимайте эту галочку, иначе получите ту самую ошибку, которую мы сейчас исправляем. Остальные шаги мастера можно оставить с настройками по умолчанию.

☑️ Проверка после установки Node.js

Выполнено: 0 / 5

После завершения установки обязательно закройте все открытые окна командной строки, PowerShell и редактора кода, затем откройте терминал заново и повторите проверку node -v. Только новый сеанс консоли считывает обновлённую переменную PATH.

Шаг 3. Добавляем Node.js в PATH вручную

Если папка C:\Program Files\nodejs существует и node.exe в ней есть, но команда не работает — путь нужно прописать вручную. Это безопасная и полностью обратимая операция.

  • 🛠️ Нажмите Win + R, введите sysdm.cpl и откройте вкладку Дополнительно.
  • 🛠️ Нажмите кнопку Переменные среды.
  • 🛠️ В списке системных переменных найдите Path, выделите её и нажмите «Изменить».
  • 🛠️ Нажмите «Создать» и добавьте строку C:\Program Files\nodejs.
  • 🛠️ Подтвердите все окна кнопкой «ОК» и перезапустите терминал.

Если Node.js установлен в нестандартное место (например, через менеджер версий nvm-windows), укажите фактический путь к папке с node.exe. Узнать его можно, открыв расположение ярлыка или выполнив поиск файла в Проводнике.

Ошибка в VS Code и других редакторах

Отдельный сценарий — node -v работает в обычной командной строке, но не работает во встроенном терминале Visual Studio Code. Причина та же: редактор был запущен до установки Node.js и «запомнил» старые переменные среды. Полностью закройте VS Code (проверьте, что процесс не остался в трее) и запустите заново.

Если перезапуск не помог, проверьте тип терминала в VS Code — переключитесь между PowerShell, Command Prompt и Git Bash. Иногда в конкретном профиле терминала переменные среды переопределены конфигурацией редактора или корпоративными политиками.

⚠️ Внимание: при использовании nvm-windows после смены активной версии командой nvm use терминал также нужно перезапустить — иначе ссылка на node.exe может указывать на неактуальный каталог.

Сводная таблица причин и решений

СимптомВероятная причинаРешение
Ошибка сразу после установкиОткрытый до установки терминалЗакрыть и открыть консоль заново
Папки nodejs нет на дискеNode.js не установленУстановить с nodejs.org (версия LTS)
node.exe есть, но команда не работаетПуть отсутствует в PATHДобавить каталог в переменные среды
Работает в cmd, не работает в VS CodeРедактор запущен до установкиПолный перезапуск редактора
Ошибка после смены версии через nvmУстаревшая ссылка на каталогПерезапуск терминала, проверка nvm use

Что делать, если ничего не помогло

В редких случаях проблема сохраняется даже после правильной установки. Тогда имеет смысл полностью удалить Node.js через Параметры → Приложения, вручную удалить остатки папок C:\Program Files\nodejs и %AppData%\npm, после чего установить актуальную версию заново. Перед установкой перезагрузите компьютер — это гарантирует, что система забудет старые записи.

Также проверьте, не содержит ли переменная PATH несколько конфликтующих записей о Node.js: старые пути от удалённых версий могут стоять в списке раньше актуального и «перехватывать» поиск. Удалите строки, ведущие в несуществующие каталоги.

Как проверить содержимое PATH

Откройте cmd и выполните команду echo %PATH% — система выведет все каталоги через точку с запятой. Найдите среди них путь к nodejs. Если его нет — добавьте через «Переменные среды». В PowerShell аналогичная проверка: $env:Path -split ";"

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

Нужно ли перезагружать компьютер после установки Node.js?

Обычно нет — достаточно закрыть и заново открыть терминал и редактор кода. Перезагрузка требуется только если переменные среды не подхватываются даже новыми сеансами консоли.

Какую версию Node.js выбрать — LTS или Current?

Для повседневной разработки и запуска проектов рекомендуется LTS: она получает длительную поддержку и стабильнее. Current подходит тем, кому нужны новейшие возможности платформы.

npm тоже не распознаётся — это связано?

Да. Пакетный менеджер npm устанавливается вместе с Node.js в ту же папку, поэтому исправление PATH решает проблему для обеих команд одновременно.

Можно ли запускать node без добавления в PATH?

Можно, указывая полный путь к исполняемому файлу, например C:\Program Files\nodejs\node.exe app.js. Но для постоянной работы удобнее один раз настроить PATH.

Ошибка появляется в Git Bash, а в cmd всё работает. Что делать?

Переустановите или обновите Git for Windows — его терминал использует собственное окружение. Также помогает полный перезапуск Git Bash после установки Node.js.