Node.js готов в каждом окружении: node, npm, npx и corepack работают в терминале, в командах ваших агентов и в скриптах npm. Несколько версий Node.js можно установить бок о бок, и каждый проект использует ту, которую запрашивает.
Какая версия достаётся проекту
node, npm, npx и corepack выбирают версию в таком порядке:
- файл
.nvmrcили.node-versionпроекта (ищется от папки, в которой вы находитесь, до корня проекта в~/Code), например22,v22.11.0,lts/*илиnode; - версия, выбранная для проекта в панели или командой
rdev node use; - версия по умолчанию.
Файл, запрашивающий неустановленную версию, останавливается с сообщением, что её нужно установить; rdev не устанавливает её сам. Диапазоны версий вроде ^20 не поддерживаются; укажите вместо этого основную версию.
В панели
Откройте сервер в разделе Серверы на боковой панели, затем Среда выполнения. Карточка Node.js перечисляет установленные версии с точным релизом и проектами, привязанными к каждой. Добавить версию Node.js устанавливает ещё одну (текущий релиз и поддерживаемые линейки LTS: сегодня это 26, 24 и 22); последний релиз этой версии скачивается с nodejs.org и проверяется по опубликованным контрольным суммам. Меню ⋯ у версии делает её версией по умолчанию или удаляет; версию по умолчанию и версию, к которой привязан проект, удалить нельзя. В разделе Проекты карандаш рядом с проектом привязывает его к версии или возвращает к версии по умолчанию. Для этого нужен rdev 0.2.0-beta.35 или новее.
На сервере
rdev node list # installed and available versions, the default and the pinned projects
rdev node install 22 # the newest Node 22
rdev node default 22
rdev node use shop 22 # pin a project; rdev node use shop default undoes it
rdev node remove 24
rdev node update # the newest release of every installed version
Агенты используют те же команды, а по MCP — rdev_node_list, rdev_node_install и rdev_node_project. Пока подписка требует внимания, установка, удаление и переключение версий приостанавливаются, как и для PHP.
Глобальные пакеты
npm install -g работает без sudo, а глобальные пакеты общие для всех версий Node.js, так что CLI, установленный один раз, остаётся в PATH независимо от версии, которую использует проект. Пакет с нативным аддоном собирается под версию, которая его установила; переустановите его после переключения, если он выдаёт ошибку. Пакеты, установленные глобально до rdev 0.2.0-beta.35, остаются с версией, которая была тогда; установите их заново один раз.