Как добавить Node.js в PATH: Windows, macOS, Linux и проверка

PATH — это список папок, где система ищет команды. Когда вы пишете node -v, терминал ищет исполняемый файл node в папках из PATH. Если Node.js установлен, но папка установки не добавлена в PATH, команда не находится

Перед ручной правкой PATH сначала проверьте простое: закройте терминал и откройте новый. После установки Node.js старое окно терминала может не увидеть изменения

Короткий ответ

Проверьте, видит ли система Node.js

На Windows

where node
where npm

На macOS и Linux

which node
which npm

Если путь не выводится, система не видит Node.js в PATH

Что делать на Windows

Если Node.js установлен обычным .msi установщиком, PATH обычно настраивается автоматически. Поэтому сначала:

1. Закройте терминал
2. Закройте VS Code, если он открыт
3. Откройте снова
4. Выполните node -v

Если не помогло, проверьте where node

where node

Если команда ничего не выводит, проще переустановить Node.js официальным установщиком и оставить стандартные настройки

Если нужно править вручную, в PATH должна быть папка установки Node.js, например

C:\Program Files\nodejs\

После изменения PATH снова откройте новый терминал

Что делать на macOS и Linux

Проверьте путь

which node
echo $PATH

Если вы ставили Node.js через nvm, убедитесь, что настройки nvm загружаются в вашем shell-профиле. После установки nvm часто нужно открыть новый терминал или выполнить команду загрузки профиля

Если вы ставили Node.js через пакетный менеджер, проверьте, установлен ли пакет и есть ли команда node

node -v
npm -v

Как понять, что PATH исправлен

После настройки выполните

node -v
npm -v

Затем запустите файл

console.log("Node.js найден в PATH")

Команда запуска

node hello.js

Если файл выполняется, PATH работает не только для проверки версии, но и для реального запуска

Когда не стоит править PATH вручную

Если вы не знаете, где именно установлен Node.js, лучше не вставлять случайные папки в PATH. Неправильная правка может привести к тому, что будет запускаться старая версия или вообще другой файл

Для новичка часто безопаснее переустановить Node.js официальным установщиком или выбрать один понятный способ установки через менеджер версий

Если в PATH несколько Node.js

На Windows where node может показать несколько строк. На macOS и Linux похожую ситуацию можно увидеть через which node и настройки shell

Если версий несколько, первой запускается та, которая находится раньше в PATH. Поэтому команда node -v может показывать не ту версию, которую вы только что установили

Мини-практика

Выполните node -v, затем where node на Windows или which node на macOS/Linux. Запишите путь и версию. Это поможет понять, какая установка Node.js реально используется

После этого откройте VS Code и проверьте те же команды во встроенном терминале. Если обычный терминал видит Node.js, а VS Code нет, перезапустите VS Code

Частые ошибки

Ошибка первая: править PATH, не перезапустив терминал после установки

Ошибка вторая: добавить в PATH не папку Node.js, а случайную папку проекта

Ошибка третья: оставить несколько установок Node.js и не понимать, какая запускается

Ошибка четвертая: ждать, что расширение VS Code само исправит PATH. Редактор не заменяет системную установку Node.js

Что почитать дальше по Node.js

Если нужен общий маршрут по теме, откройте рубрику Node.js. Для соседних задач пригодятся эти разборы:

• Как установить Node.js: Windows, macOS, Linux и проверка npm
• Как обновить Node.js через консоль: Windows, macOS, Linux и nvm
• Как установить Node.js на Windows 10 и 11: скачивание, PATH и проверка
• Как удалить Node.js и npm полностью: Windows, Ubuntu, macOS