Как поставить определенную версию Node.js: nvm, engines и пр

Короткий ответ: для точной версии Node.js удобнее использовать менеджер версий. На macOS и Linux чаще берут nvm, на Windows — nvm-windows. Вы ставите нужную версию, переключаетесь на нее и проверяете node -v

Этот материал закрывает запросы «как поставить определенную версию node js», «npm install version», «как установить последнюю версию node js», «как сменить версию node» и похожие формулировки. Важно сразу развести два смысла: npm install package@version ставит конкретную версию пакета, а не конкретную версию самого Node.js

Содержание

Если нужна версия Node.js
Если нужна последняя LTS-версия
Если нужна версия npm-пакета
Как понять, какая версия нужна проекту
Как закрепить версию для команды
Что делать на Windows
Мини-практика
Частые ошибки
Что почитать дальше по Node.js

Если нужна версия Node.js

Пример для nvm

nvm install 20.11.1
nvm use 20.11.1
node -v

Ожидаемый вывод

v20.11.1

Можно поставить не только точную версию, но и крупную ветку

nvm install 18
nvm use 18

nvm поставит подходящую версию внутри ветки 18

Если нужна последняя LTS-версия

Для учебных и рабочих проектов чаще выбирают LTS

nvm install --lts
nvm use --lts
node -v

Такой вариант лучше, чем вручную угадывать свежий номер версии. Но если проект требует строго 18.19.0 или 20.11.1, используйте точный номер

Если нужна версия npm-пакета

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

npm install express@4
npm install lodash@4.17.21

Это не меняет Node.js. Это ставит конкретную версию зависимости внутри проекта

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

Сначала проверьте документацию проекта. Часто версия указана в README.md, .nvmrc или package.json

Пример .nvmrc

Пример package.json

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

Если видите .nvmrc, выполните в папке проекта

nvm use

Если нужная версия еще не установлена, nvm подскажет поставить ее

Как закрепить версию для команды

Если над проектом работают несколько человек, полезно добавить .nvmrc. Тогда каждый сможет включить нужную версию одинаково

node -v > .nvmrc

После этого откройте файл и проверьте, что там записана именно нужная версия. Иногда удобнее хранить крупную ветку, например 20, а не полный номер

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

На Windows можно использовать nvm-windows. Логика похожая: установить версию, выбрать ее, проверить node -v

Примерно так

nvm install 20.11.1
nvm use 20.11.1
node -v

Если вы раньше ставили Node.js обычным установщиком, проверьте, не конфликтуют ли несколько установок. Команда where node покажет, откуда запускается Node.js

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

Поставьте одну версию Node.js, проверьте node -v, затем переключитесь на другую и снова проверьте версию. После этого создайте файл version.js

console.log(process.version);

Запустите его после каждого переключения. Так вы увидите, что версия меняется не только в терминале, но и внутри программы

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

Поставили версию, но не переключились на нее Команда nvm install устанавливает версию, а nvm use делает ее активной

Использовали npm install для версии Node.js npm install node@16 не является нормальным способом установки Node.js для проекта. Для версий Node.js используйте nvm или официальный установщик

Проект просит одну версию, а терминал показывает другую Проверьте .nvmrc, package.json, node -v, which node или where node

После смены версии сломались зависимости Удалите node_modules и установите зависимости заново. Пакеты могли быть собраны под другую версию Node.js