Node.js est prêt dans chaque environnement : node, npm, npx et corepack fonctionnent dans le terminal, dans les commandes de vos agents et dans les scripts npm. Plusieurs versions de Node.js peuvent être installées côte à côte, et chaque projet utilise celle qu'il demande.
Quelle version obtient un projet
node, npm, npx et corepack choisissent la version dans cet ordre :
- le fichier
.nvmrcou.node-versiondu projet (recherché depuis le dossier où vous êtes jusqu'à la racine du projet dans~/Code), comme22,v22.11.0,lts/*ounode; - la version choisie pour le projet dans le panneau ou avec
rdev node use; - la version par défaut.
Un fichier qui demande une version non installée s'arrête avec un message vous indiquant de l'installer ; rdev ne l'installe pas de lui-même. Les plages de versions comme ^20 ne sont pas comprises ; écrivez plutôt la version majeure.
Dans le panneau
Ouvrez le serveur depuis Serveurs dans la barre latérale, puis Exécution. La carte Node.js liste les versions installées avec leur release exacte et les projets rattachés à chacune. Ajouter une version de Node.js en installe une autre (la release actuelle et les lignes LTS maintenues : 26, 24 et 22 aujourd'hui) ; la dernière release de cette version est téléchargée depuis nodejs.org et vérifiée avec ses sommes de contrôle publiées. Le menu ⋯ d'une version permet de la définir par défaut ou de la supprimer ; la version par défaut et une version à laquelle un projet est rattaché ne peuvent pas être supprimées. Sous Projets, le crayon à côté d'un projet le rattache à une version ou le remet sur la version par défaut. Cela nécessite rdev 0.2.0-beta.35 ou une version ultérieure.
Sur le serveur
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
Les agents utilisent les mêmes commandes, et via MCP rdev_node_list, rdev_node_install et rdev_node_project. Tant qu'un abonnement demande de l'attention, l'installation, la suppression et le changement de versions sont suspendus, comme pour PHP.
Paquets globaux
npm install -g fonctionne sans sudo, et les paquets globaux sont partagés par toutes les versions de Node.js, de sorte qu'un outil en ligne de commande installé une fois reste dans le PATH quelle que soit la version utilisée par un projet. Un paquet avec un addon natif est compilé pour la version qui l'a installé ; réinstallez-le après un changement s'il pose problème. Les paquets installés globalement avant rdev 0.2.0-beta.35 restent avec la version qui existait alors ; réinstallez-les une fois.