Как сменить версию Node.js: nvm, проектная версия и проверка

Версию Node.js часто приходится менять, когда один проект требует Node 16, другой — Node 18, а новый проект лучше работает на LTS-версии. Ставить и удалять Node.js каждый раз вручную неудобно, поэтому для таких задач используют менеджер версий

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

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

Проверьте текущую версию

node -v

Установите нужную версию через менеджер версий

nvm install 20
nvm use 20
node -v

Если node -v показывает нужный номер, версия переключилась

Зачем нужен менеджер версий

Без менеджера версий у вас обычно одна системная установка Node.js. Если проект требует другую версию, приходится обновлять или переустанавливать Node.js целиком

Менеджер версий решает это иначе:

• хранит несколько версий Node.js
• позволяет выбрать нужную версию для проекта
• уменьшает конфликт между старым и новым кодом
• помогает работать с .nvmrc, если проект его использует

Как понять, какая версия нужна проекту

Посмотрите файлы проекта. Версия может быть указана в .nvmrc

20

Или в package.json

{
  "engines": {
    "node": ">=20"
  }
}

Если проект требует Node.js 20, а у вас Node.js 16, зависимости могут не ставиться или код может падать при запуске

Как проверить активную версию

После переключения всегда проверяйте

node -v
npm -v

Еще полезно посмотреть путь к Node.js

На macOS и Linux

which node

На Windows

where node

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

Что делать с проектом после смены версии

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

npm install

Если были серьезные проблемы, иногда удаляют node_modules и ставят зависимости заново. Но не начинайте с удаления, пока не понимаете причину ошибки

Можно ли поставить определенную версию Node.js без менеджера

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

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

Создайте папку node-version-demo, проверьте node -v, затем переключитесь на другую доступную версию через ваш менеджер версий и снова выполните node -v

После этого создайте файл version.js

console.log(process.version)

Запустите

node version.js

Так вы проверите версию не только в терминале, но и внутри кода

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

Ошибка первая: поставить новую версию, но не выполнить команду переключения

Ошибка вторая: открыть старый терминал. После смены PATH или установки менеджера версий иногда нужно открыть новое окно

Ошибка третья: смешать обычный установщик, nvm и системный пакетный менеджер. Так легко получить несколько node в разных местах

Ошибка четвертая: обновить Node.js глобально и не проверить требования старого проекта

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

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

• Как поставить определенную версию Node.js: nvm, engines и проверка
• Как обновить Node.js до 16: nvm, проверка версии и старые проекты
• Как скачать Node.js: официальный сайт, LTS-версия и проверка
• Как узнать версию Node.js: команда в терминале и проверка из кода