Ошибка компилятора Node.js в терминале VS Code исправляется проверкой переменной окружения PATH, переустановкой Node.js с добавлением в системный путь или указанием полного пути к исполняемому файлу node.exe в настройках VS Code.
Причины ошибок с путями Node.js
- Node.js установлен, но не добавлен в переменную окружения
PATHоперационной системы - Терминал VS Code запущен до установки Node.js и не обновил переменные окружения
- Неправильный путь установки Node.js или конфликт версий при наличии нескольких установок
- Отсутствие прав администратора при добавлении пути к Node.js в системные переменные
- Использование встроенного PowerShell вместо cmd или bash, где пути настраиваются по-другому
- Кэширование старых путей в переменных окружения после переустановки Node.js
Проверка установки Node.js и текущих путей
- Откройте встроенный терминал VS Code горячей клавишей
Ctrl+`(Windows/Linux) илиCmd+`(macOS) - Введите команду
node --versionи нажмитеEnter - Если появилось сообщение вроде
'node' is not recognized as an internal or external command, Node.js не добавлен в PATH - Если версия отобразилась, введите команду
npm --versionдля проверки npm - Введите команду
where node(Windows) илиwhich node(macOS/Linux) для определения пути установки - Скопируйте полученный путь — он понадобится для дальнейшей настройки
Пошаговое исправление путей на Windows
- Откройте меню
Пуски введитеПеременные окружения - Нажмите на результат
Изменить переменные окружения для вашей учётной записи - В открывшемся окне нажмите кнопку
Переменные средывнизу - В разделе
Переменные пользователянайдите переменнуюPATHи нажмите кнопкуИзменить - Если переменная
PATHотсутствует, нажмите кнопкуСоздатьи впишите имяPATH - В поле значения добавьте путь к папке установки Node.js (например,
C:\Program Files\nodejs) - Если в PATH уже есть несколько путей, нажмите кнопку
Создатьв этом же окне и добавьте новый путь на отдельной строке - Нажмите
OKдля сохранения изменений - Полностью закройте VS Code через
Ctrl+Q - Откройте VS Code заново — изменения переменных окружения вступят в силу
- Проверьте в терминале команду
node --versionдля подтверждения исправления
Пошаговое исправление путей на macOS и Linux
- Откройте встроенный терминал VS Code горячей клавишей
Ctrl+` - Введите команду
nano ~/.bash_profile(для bash) илиnano ~/.zshrc(для zsh) - Добавьте в конец файла строку:
export PATH="/usr/local/bin:$PATH" - Если Node.js установлен в другое место, замените
/usr/local/binна полный путь из результата командыwhich node - Нажмите
Ctrl+O, затемEnterдля сохранения файла - Нажмите
Ctrl+Xдля выхода из редактора - Введите команду
source ~/.bash_profileилиsource ~/.zshrcдля применения изменений - Проверьте команду
node --versionдля подтверждения исправления
Переустановка Node.js с добавлением в PATH
- Полностью удалите текущую установку Node.js через
Панель управления→Программы и компоненты(Windows) или черезbrew uninstall node(macOS) - Загрузите последнюю стабильную версию Node.js с официального сайта
nodejs.org - Запустите установщик и на шаге настройки убедитесь, что отмечен флажок
Add to PATH - Завершите установку, согласившись со всеми предложенными параметрами
- Перезагрузите компьютер для применения изменений переменных окружения
- Откройте VS Code и проверьте
node --versionв терминале
Настройка пути в settings.json VS Code (альтернативный метод)
- Откройте
settings.jsonчерезCtrl+Shift+Pи введитеPreferences: Open Settings (JSON) - Добавьте следующую строку в конец объекта конфигурации перед последней закрывающей скобкой:
"terminal.integrated.env.windows": { "PATH": "C:\\Program Files\\nodejs;${env:PATH}" }(для Windows, замените путь на ваш)- Для macOS/Linux добавьте:
"terminal.integrated.env.osx": { "PATH": "/usr/local/bin:${env:PATH}" } - Сохраните файл горячей клавишей
Ctrl+S - Закройте и откройте VS Code заново для применения настроек
- Проверьте работу в терминале командой
node --version
Проверка и устранение конфликтов версий Node.js
- Введите в терминал команду
where node(Windows) илиwhich node(macOS/Linux) - Если вывод содержит несколько путей, это указывает на конфликт версий
- Определите, какая версия используется по умолчанию (обычно первая в списке)
- Удалите все альтернативные установки Node.js через панель управления или
brew uninstall - Оставьте только одну требуемую версию
- Перезагрузите компьютер и проверьте команду
node --version
Часто задаваемые вопросы (FAQ)
Почему после добавления PATH в переменные окружения команда node всё ещё не работает? Закройте VS Code полностью и откройте его заново, так как переменные окружения обновляются при запуске приложения.
Какой терминал выбрать в VS Code для корректной работы Node.js? Используйте cmd.exe (Windows) или bash/zsh (macOS/Linux) вместо PowerShell, если возникают проблемы с путями.
Безопасно ли использовать полный путь к node.exe в settings.json вместо переменной PATH? Да, это безопасный способ, но менее гибкий при обновлении версий Node.js, так как путь может измениться.