Guida all'impostazione delle versioni di Node.js per progetti utilizzando ServBay

ServBay, come ambiente di sviluppo integrato, supporta nativamente la gestione parallela di più versioni di Node.js e il passaggio rapido tra di esse, risolvendo la complessità e il consumo di risorse degli strumenti tradizionali (come NVM o Docker). Di seguito è riportato un piano di configurazione completo per casi d'uso comuni:

Controllo delle versioni a livello di progetto tramite `.servbay.config`

1. Principio di base

ServBay pre-installato tutte le versioni principali di Node.js dalla v12 alla v23 su macOS (arm64/x86_64), permettendo ad ogni progetto di collegarsi dinamicamente alla versione necessaria tramite un file di configurazione.

Vantaggi: • Non è necessaria l'installazione o la compilazione manuale, evitando conflitti di versione
• Supporta l'esecuzione simultanea di più versioni (ad esempio, progetto A usa Node 18, progetto B usa Node 22)
• Decoupled dai servizi PHP, database e altri, l'ambiente indipendente non inquina il sistema

2. Passaggi di configurazione

Passaggio 1: Creare il file di configurazione
Nella directory principale del progetto, creare un file .servbay.config e aggiungere il seguente contenuto:

bash

NODE_VERSION=20  # Specifica Node.js 20.x  
# Facoltativo: configura il mirror npm/pnpm (ad esempio, per il miglioramento della rete)  
YARN_CONFIG_REGISTRY=https://npmreg.proxy.ustclug.org/
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com  
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache

Passaggio 2: Verificare l'efficacia della versione

bash

$ node -v  
v20.12.2  # Deve corrispondere al file di configurazione  
$ npm run dev  # La risoluzione delle dipendenze si basa sulla versione corrente di Node

3. Funzionalità avanzate

• Coesistenza di più versioni: quando si cambia directory nella stessa finestra del terminale, viene caricata automaticamente la versione corrispondente di Node.js
• Gestione della cache: specificare la directory della cache tramite NPM_CONFIG_CACHE, evitando inquinamento globale
• Supporto per toolchain: include gestori di pacchetti come npm, pnpm, yarn, ecc., con versioni rigorosamente corrispondenti a Node.js

Esempio di esecuzione

Di seguito viene utilizzato un esempio pratico per dimostrare il meccanismo di funzionamento di .servbay.config.

Guida all'impostazione delle versioni di Node.js per progetti utilizzando ServBay ​

Controllo delle versioni a livello di progetto tramite .servbay.config ​

1. Principio di base ​

2. Passaggi di configurazione ​

3. Funzionalità avanzate ​