Digita almeno due lettere per cercare in ogni pagina della documentazione.

↑ ↓ per navigare ↵ per aprire esc per chiudere

Usare rdev

Versioni di Node.js

Node.js è pronto in ogni ambiente: node, npm, npx e corepack funzionano nel terminale, nei comandi dei tuoi agenti e negli script npm. Più versioni di Node.js possono essere installate affiancate, e ogni progetto usa quella che richiede.

Quale versione ottiene un progetto

node, npm, npx e corepack scelgono la versione in quest'ordine:

  1. il file .nvmrc o .node-version del progetto (cercato dalla cartella in cui ti trovi fino alla radice del progetto in ~/Code), ad esempio 22, v22.11.0, lts/* o node;
  2. la versione scelta per il progetto nel pannello o con rdev node use;
  3. la versione predefinita.

Un file che richiede una versione non installata si ferma con un messaggio che ti dice di installarla; rdev non la installa da solo. Gli intervalli di versione come ^20 non sono supportati; scrivi invece la versione principale.

Nel pannello

Apri il server da Server nella barra laterale, poi Runtime. La scheda Node.js elenca le versioni installate con la loro release esatta e quali progetti sono fissati a ciascuna. Aggiungi versione di Node.js ne installa un'altra (la release corrente e le linee LTS mantenute: oggi 26, 24 e 22); l'ultima release di quella versione viene scaricata da nodejs.org e verificata con i checksum pubblicati. Il menu ⋯ di una versione la rende predefinita o la rimuove; la versione predefinita e una versione a cui è fissato un progetto non possono essere rimosse. In Progetti, la matita accanto a un progetto lo fissa a una versione o lo riporta a quella predefinita. Serve rdev 0.2.0-beta.35 o successivo.

Sul server

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

Gli agenti usano gli stessi comandi, e tramite MCP rdev_node_list, rdev_node_install e rdev_node_project. Mentre un abbonamento richiede attenzione, l'installazione, la rimozione e il cambio di versione sono sospesi come per PHP.

Pacchetti globali

npm install -g funziona senza sudo, e i pacchetti globali sono condivisi da ogni versione di Node.js, quindi una CLI che installi una volta resta nel PATH qualunque versione usi un progetto. Un pacchetto con un addon nativo viene compilato per la versione che lo ha installato; reinstallalo dopo il cambio se dà problemi. I pacchetti installati globalmente prima di rdev 0.2.0-beta.35 restano con la versione presente allora; reinstallali una volta.