Guide de configuration indépendante des versions de Node.js pour projets avec ServBay

ServBay, en tant qu'environnement de développement intégré, prend en charge nativement la gestion parallèle de plusieurs versions de Node.js et le changement rapide entre celles-ci, résolvant ainsi les problèmes de complexité et de consommation de ressources des outils traditionnels (comme NVM ou Docker). Voici le scénario de configuration complet pour les cas courants :

Contrôle de version au niveau projet via `.servbay.config`

1. Principes de base

ServBay préinstalle sur macOS (arm64/x86_64) toutes les versions principales de Node.js v12 à v23, permettant à chaque projet de lier dynamiquement la version requise via un fichier de configuration.

Avantages :
• Pas besoin d'installer ou de compiler manuellement, évitant ainsi les conflits de version
• Prise en charge de l'exécution simultanée de plusieurs versions (par exemple, projet A utilisant Node 18 et projet B utilisant Node 22)
• Découplage des services tels que PHP et bases de données, l'environnement d'exécution indépendant ne pollue pas le système

2. Étapes de configuration

Étape 1 : Créer le fichier de configuration
Dans le répertoire racine du projet, créez un fichier .servbay.config et ajoutez le contenu suivant :

bash

NODE_VERSION=20  # Spécifie Node.js 20.x  
# Optionnel : configurer le miroir npm/pnpm (comme accélération réseau)  
YARN_CONFIG_REGISTRY=https://npmreg.proxy.ustclug.org/
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com  
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache

Étape 2 : Vérifier que la version est active

bash

$ node -v  
v20.12.2  # Devrait correspondre au fichier de configuration  
$ npm run dev  # La résolution des dépendances est basée sur la version actuelle de Node

3. Fonctionnalités avancées

• Coexistence de plusieurs versions : Lors de la commutation des répertoires dans la même fenêtre de terminal, la version correspondante de Node.js se charge automatiquement
• Gestion du cache : Spécifiez le répertoire de cache via NPM_CONFIG_CACHE, évitant ainsi la pollution globale
• Support de la chaîne d'outils : Intègre des gestionnaires de packages comme npm, pnpm, yarn, les versions étant strictement synchronisées avec Node.js

Exemples d'exécution

Voici un exemple pratique démontrant le mécanisme de fonctionnement de .servbay.config.

Guide de configuration indépendante des versions de Node.js pour projets avec ServBay ​

Contrôle de version au niveau projet via .servbay.config ​

1. Principes de base ​

2. Étapes de configuration ​

3. Fonctionnalités avancées ​