O Node.js vem pronto em todos os ambientes: node, npm, npx e corepack funcionam no terminal, nos comandos dos seus agentes e nos scripts do npm. Várias versões do Node.js podem ser instaladas lado a lado, e cada projeto usa a que pede.
Qual versão um projeto recebe
node, npm, npx e corepack escolhem a versão nesta ordem:
- o arquivo
.nvmrcou.node-versiondo projeto (procurado da pasta em que você está até a raiz do projeto em~/Code), como22,v22.11.0,lts/*ounode; - a versão escolhida para o projeto no painel ou com
rdev node use; - a versão padrão.
Um arquivo que pede uma versão que não está instalada para com uma mensagem pedindo que você a instale; o rdev não a instala por conta própria. Intervalos de versão como ^20 não são entendidos; escreva a versão principal em vez disso.
No painel
Abra o servidor em Servidores na barra lateral e depois em Runtime. O card Node.js lista as versões instaladas com a versão exata e quais projetos estão fixados em cada uma. Adicionar versão do Node.js instala outra (a versão atual e as linhas LTS mantidas: 26, 24 e 22 hoje); a versão mais recente dessa linha é baixada de nodejs.org e verificada com os checksums publicados. O menu ⋯ de uma versão a define como padrão ou a remove; a versão padrão e uma versão à qual um projeto está fixado não podem ser removidas. Em Projetos, o lápis ao lado de um projeto o fixa em uma versão ou o devolve ao padrão. Isso exige o rdev 0.2.0-beta.35 ou posterior.
No servidor
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
Os agentes usam os mesmos comandos, e por MCP rdev_node_list, rdev_node_install e rdev_node_project. Enquanto uma assinatura precisa de atenção, instalar, remover e trocar versões ficam pausados, como no PHP.
Pacotes globais
O npm install -g funciona sem sudo, e os pacotes globais são compartilhados por todas as versões do Node.js, então uma CLI que você instala uma vez permanece no PATH seja qual for a versão que um projeto usa. Um pacote com um addon nativo é compilado para a versão que o instalou; reinstale-o após trocar se ele reclamar. Os pacotes instalados globalmente antes do rdev 0.2.0-beta.35 permanecem com a versão que existia então; instale-os de novo uma vez.