
Node.js требует корректного указания пути к исполняемому файлу в системной переменной PATH, чтобы команды node и npm были доступны из любого каталога. Без этого разработка с использованием Node.js ограничена запуском скриптов только из папки установки.
Для Windows путь к Node.js обычно выглядит как C:\Program Files\nodejs\. Этот путь нужно добавить в системные переменные через Панель управления → Система → Дополнительные параметры системы → Переменные среды. Изменения вступают в силу после перезапуска командной строки.
На Linux и macOS добавление Node.js в PATH выполняется редактированием файлов конфигурации оболочки, например ~/.bashrc, ~/.zshrc или ~/.profile. Достаточно добавить строку export PATH=$PATH:/usr/local/bin/node и выполнить source ~/.bashrc для применения изменений.
Проверка корректного добавления осуществляется командой node -v для версии Node.js и npm -v для менеджера пакетов. Любое несоответствие пути приводит к ошибкам запуска скриптов и невозможности установки глобальных пакетов.
Правильная настройка PATH обеспечивает стабильную работу инструментов Node.js, ускоряет запуск скриптов и гарантирует совместимость с глобальными пакетами и инструментами сборки.
Проверка текущего состояния PATH на компьютере
Для корректной работы Node.js важно убедиться, что путь к его исполняемым файлам добавлен в системную переменную PATH. Проверка PATH позволяет выявить конфликты версий и отсутствующие директории.
На Windows используйте команду:
echo %PATH%
В PowerShell:
$env:PATH
На macOS и Linux:
echo $PATH
| Операционная система | Команда проверки PATH | Примечание |
|---|---|---|
| Windows | echo %PATH% |
Директории разделены ;, проверка наличия node.exe в каждом каталоге |
| PowerShell | $env:PATH |
|
| macOS / Linux | echo $PATH |
Директории разделены :, проверка наличия node через which node |
Для детальной проверки наличия Node.js выполните команду:
node -v
Рекомендуется сохранять резервную копию текущего PATH перед изменениями, чтобы избежать потери системных путей.
Скачивание и установка Node JS на Windows
Перейдите на официальный сайт Node.js по адресу https://nodejs.org/. Для Windows доступны две версии: Current – с последними функциями, и LTS (Long Term Support) – стабильная версия для долгосрочного использования. Рекомендуется выбирать LTS для проектов, требующих стабильности.
Скачайте Windows Installer (.msi), соответствующий вашей разрядности: 32-bit или 64-bit. После загрузки запустите установщик и следуйте пошаговой инструкции.
В процессе установки отметьте галочку Add to PATH, чтобы автоматически добавить Node.js и npm в системные переменные. Это позволит запускать команды node и npm из любой директории.
Выберите стандартный путь установки или укажите собственную директорию. Настройка дополнительных компонентов, таких как npm package manager, Online documentation shortcuts и Tools for Native Modules, рекомендуется оставить включенной.
После завершения установки откройте командную строку (cmd) или PowerShell и выполните node -v и npm -v, чтобы проверить успешность установки и корректность добавления в PATH.
Если команды не определяются, проверьте системную переменную PATH: путь к Node.js должен присутствовать, обычно это C:\Program Files\nodejs\.
Добавление пути к Node JS вручную через свойства системы
Откройте «Панель управления» → «Система и безопасность» → «Система». Нажмите «Дополнительные параметры системы» в левой панели и перейдите во вкладку «Дополнительно». Нажмите кнопку «Переменные среды».
В разделе «Системные переменные» найдите переменную с именем PATH и выделите её, затем нажмите «Изменить». В открывшемся окне добавьте новый путь к Node JS, например: C:\Program Files\nodejs\. Убедитесь, что путь заканчивается обратным слэшем и не содержит пробелов после него.
Если используется Windows 10 или выше, можно добавить путь отдельной строкой через кнопку «Создать». В более старых версиях Windows добавляйте путь через точку с запятой ; в конце существующей строки переменной.
После добавления пути нажмите «ОК» для закрытия всех окон. Откройте новую командную строку и выполните node -v и npm -v для проверки корректности установки и доступности Node JS из любой директории.
При наличии нескольких версий Node JS убедитесь, что путь к нужной версии находится выше других путей в переменной PATH, чтобы система использовала требуемую версию по умолчанию.
Проверка успешного добавления Node JS в PATH через командную строку

После добавления Node JS в системную переменную PATH необходимо убедиться, что операционная система корректно распознаёт путь к исполняемым файлам. Для этого используется командная строка.
- Откройте терминал или командную строку:
- Windows: нажмите Win + R, введите
cmdи нажмите Enter. - macOS/Linux: откройте Terminal.
- Проверьте версию Node JS, введя команду:
node -vЕсли Node JS добавлен в PATH корректно, команда выведет номер версии, например:
v20.4.0. - Проверьте версию npm (Node Package Manager) для дополнительной проверки:
npm -v - Определите точное расположение исполняемого файла Node JS:
- Windows:
where node - macOS/Linux:
which node
Команда должна вернуть путь к
node.exeили бинарнику Node JS. Если путь отсутствует, переменная PATH настроена некорректно. - Windows:
- При проблемах:
- Проверьте, что путь к папке Node JS добавлен в системный PATH, а не только в пользовательский.
- Перезапустите командную строку после изменения переменной PATH.
- Убедитесь, что нет конфликтующих версий Node JS в PATH.
После выполнения этих шагов можно быть уверенным, что Node JS полностью интегрирован в системный PATH и готов к использованию в командной строке и скриптах.
Исправление ошибок при некорректном PATH

Некорректная настройка переменной PATH может привести к ошибкам при запуске Node.js и npm. Основные признаки проблем:
- Команда
node -vвозвращает «неопределено» или «не является внутренней командой». - Команда
npmне распознается. - Ошибки при глобальной установке пакетов.
Для устранения проблем выполните следующие действия:
- Проверьте текущий PATH:
- Windows:
echo %PATH% - Linux/macOS:
echo $PATH
- Windows:
- Убедитесь, что путь к Node.js существует. По умолчанию:
- Windows:
C:\Program Files\nodejs\ - Linux/macOS:
/usr/local/bin
- Windows:
- Удалите дублирующиеся или неверные записи в PATH:
- Windows: «Система → Дополнительные параметры системы → Переменные среды».
- Linux/macOS: редактируйте
~/.bashrc,~/.zshrcили/etc/profile.
- Добавьте корректный путь к Node.js:
- Windows:
C:\Program Files\nodejs\ - Linux/macOS:
export PATH=$PATH:/usr/local/bin
- Windows:
- Примените изменения:
- Windows: откройте новую консоль.
- Linux/macOS: выполните
source ~/.bashrcилиsource ~/.zshrc.
- Проверьте работу Node.js и npm:
node -vnpm -v
Если PATH корректен, но команды все еще не работают, проверьте права доступа к каталогу Node.js и целостность файлов. На Windows иногда помогает переустановка Node.js с опцией «Add to PATH».
Обновление PATH без перезагрузки компьютера

После добавления Node.js в системную переменную PATH можно обновить среду без полной перезагрузки. В Windows откройте Командную строку (cmd) или PowerShell и выполните команду:
setx PATH «%PATH%;C:\Program Files\nodejs»
Эта команда сохраняет новый путь в системных переменных и делает его доступным для новых сеансов командной строки. Чтобы изменения вступили в силу в текущей сессии cmd, выполните:
refreshenv
Для PowerShell используйте:
$env:PATH += «;C:\Program Files\nodejs»
Эта команда обновляет переменную PATH только для текущей сессии PowerShell без влияния на другие процессы. После этого можно сразу проверить доступность Node.js командой:
node -v
Если версия отображается корректно, PATH обновлен успешно. Эти методы позволяют избежать перезагрузки системы и сразу использовать Node.js в новых и текущих сеансах терминала.
Вопрос-ответ:
Что такое системная переменная PATH и зачем Node JS нужно туда добавлять?
Системная переменная PATH хранит список директорий, в которых операционная система ищет исполняемые файлы при запуске команд через терминал или командную строку. Если Node JS не добавлен в PATH, система не сможет распознавать команды типа node или npm без указания полного пути к файлу. Добавление Node JS в PATH позволяет запускать его инструменты из любой папки.
Как проверить, добавлен ли Node JS в PATH на Windows?
Для проверки нужно открыть командную строку и ввести node -v. Если система выдаёт версию Node JS, значит переменная настроена правильно. Если появляется сообщение об ошибке типа «Команда не распознана», Node JS в PATH не добавлен. Также можно посмотреть содержимое PATH через echo %PATH% и убедиться, что путь к папке с Node JS присутствует.
Можно ли добавить Node JS в PATH без перезагрузки компьютера?
Да, изменения можно применить без полной перезагрузки. На Windows после добавления пути к Node JS через «Свойства системы → Переменные среды» достаточно закрыть и заново открыть командную строку или PowerShell. Новые сессии терминала будут видеть обновлённый PATH.
Как правильно добавить Node JS в PATH на macOS или Linux?
На macOS или Linux PATH обычно настраивается через файл конфигурации оболочки, например ~/.bashrc, ~/.zshrc или ~/.profile. Нужно добавить строку export PATH=$PATH:/путь/к/node в конец файла и сохранить его. После этого необходимо выполнить source ~/.bashrc или аналогичную команду для выбранного файла, чтобы изменения вступили в силу.
Что делать, если после добавления Node JS в PATH команда всё равно не работает?
Сначала убедитесь, что путь указан правильно и ведёт именно к папке с исполняемым файлом node. Проверьте, нет ли лишних пробелов или опечаток. На Windows также стоит убедиться, что изменения внесены в переменные среды для текущего пользователя или системы. Если проблема остаётся, можно открыть новый терминал и попробовать снова, а при необходимости удалить и добавить путь заново.
Почему после установки Node.js команды `node` и `npm` не работают в терминале?
Это происходит потому, что системная переменная PATH не содержит путь к установленной папке Node.js. Windows и другие операционные системы используют PATH для поиска исполняемых файлов. Если Node.js не добавлен в PATH, терминал не сможет найти `node` или `npm`, даже если они установлены. Решением является добавление директории с исполняемыми файлами Node.js в переменную PATH. Для Windows это обычно папка вида `C:\Program Files\nodejs\`. После добавления переменной PATH необходимо перезапустить терминал, чтобы изменения вступили в силу.
