Guía para configurar versiones independientes de Node.js para proyectos usando ServBay

ServBay, como un entorno de desarrollo integrado, admite de forma nativa la gestión paralela de múltiples versiones de Node.js y su cambio rápido, resolviendo la complejidad y el consumo de recursos de herramientas tradicionales (como NVM o Docker). A continuación, se presentan los esquemas de configuración completos para escenarios comunes:

Control de versiones a nivel de proyecto a través de `.servbay.config`

1. Principio básico

ServBay viene preinstalado con todas las versiones principales de Node.js v12 a v23 en macOS (arm64/x86_64); cada proyecto puede vincular dinámicamente la versión requerida a través de un archivo de configuración.

Ventajas: • No es necesario instalar o compilar manualmente, evitando conflictos de versiones
• Soporta la ejecución simultánea de múltiples versiones (por ejemplo, proyecto A con Node 18, proyecto B con Node 22)
• Desacoplado de servicios como PHP y bases de datos, el entorno independiente no contamina el sistema

2. Pasos de configuración

Paso 1: Crear el archivo de configuración
Cree un nuevo archivo .servbay.config en el directorio raíz del proyecto y agregue el siguiente contenido:

bash

NODE_VERSION=20  # Especificar Node.js 20.x  
# Opcional: configurar el espejo de npm/pnpm (para acelerar la red)  
YARN_CONFIG_REGISTRY=https://npmreg.proxy.ustclug.org/
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com  
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache

Paso 2: Verificar que la versión esté activa

bash

$ node -v  
v20.12.2  # Debería coincidir con el archivo de configuración  
$ npm run dev  # La resolución de dependencias se basa en la versión actual de Node

3. Funciones avanzadas

• Coexistencia de múltiples versiones: al cambiar de directorio en la misma ventana de terminal, se cargará automáticamente la versión correspondiente de Node.js
• Gestión de caché: mediante NPM_CONFIG_CACHE se especifica el directorio de caché, evitando la contaminación global
• Soporte para herramientas: incluye gestores de paquetes como npm, pnpm y yarn, con versiones estrictamente coincidentes con Node.js

Ejemplo de ejecución

A continuación, se muestra un ejemplo práctico que ilustra el mecanismo de funcionamiento de .servbay.config.

Guía para configurar versiones independientes de Node.js para proyectos usando ServBay ​

Control de versiones a nivel de proyecto a través de .servbay.config ​

1. Principio básico ​

2. Pasos de configuración ​

3. Funciones avanzadas ​