Escribe al menos dos letras para buscar en todas las páginas de la documentación.

↑ ↓ para navegar ↵ para abrir esc para cerrar

Uso de rdev

Versiones de Node.js

Node.js viene listo en cada entorno: node, npm, npx y corepack funcionan en la terminal, en los comandos de tus agentes y en los scripts de npm. Se pueden instalar varias versiones de Node.js en paralelo, y cada proyecto usa la que pide.

Qué versión recibe un proyecto

node, npm, npx y corepack eligen la versión en este orden:

  1. el archivo .nvmrc o .node-version del proyecto (se busca desde la carpeta en la que estás hasta la raíz del proyecto en ~/Code), como 22, v22.11.0, lts/* o node;
  2. la versión elegida para el proyecto en el panel o con rdev node use;
  3. la versión predeterminada.

Un archivo que pide una versión que no está instalada se detiene con un mensaje que te indica que la instales; rdev no la instala por sí solo. Los rangos de versiones como ^20 no se entienden; escribe la versión mayor en su lugar.

En el panel

Abre el servidor desde Servidores en la barra lateral y luego Entorno de ejecución. La tarjeta Node.js lista las versiones instaladas con su versión exacta y qué proyectos están fijados a cada una. Añadir versión de Node.js instala otra (la versión actual y las líneas LTS mantenidas: hoy la 26, la 24 y la 22); la última versión publicada de esa versión se descarga de nodejs.org y se comprueba con sus sumas de verificación publicadas. El menú ⋯ de una versión la hace predeterminada o la quita; no se pueden quitar la versión predeterminada ni una versión a la que está fijado un proyecto. En Proyectos, el lápiz junto a un proyecto lo fija a una versión o lo devuelve a la predeterminada. Esto requiere rdev 0.2.0-beta.35 o posterior.

En el 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

Los agentes usan los mismos comandos, y mediante MCP rdev_node_list, rdev_node_install y rdev_node_project. Mientras una suscripción requiere atención, instalar, quitar y cambiar versiones se pausan igual que con PHP.

Paquetes globales

npm install -g funciona sin sudo, y los paquetes globales se comparten entre todas las versiones de Node.js, de modo que una CLI que instalas una vez se queda en el PATH sea cual sea la versión que use un proyecto. Un paquete con un complemento nativo se compila para la versión que lo instaló; reinstálalo después de cambiar si da problemas. Los paquetes instalados globalmente antes de rdev 0.2.0-beta.35 se quedan con la versión que había entonces; instálalos de nuevo una vez.