Guia para Configuração Independente de Versões do Node.js com ServBay

ServBay, como um ambiente de desenvolvimento integrado, suporta nativamente o gerenciamento paralelo e a troca rápida de várias versões do Node.js, resolvendo problemas de complexidade e consumo de recursos típicos de ferramentas tradicionais (como NVM ou Docker). A seguir, apresentamos o esquema completo de configuração para cenários comuns:

Controle de Versão a Nível de Projeto com `.servbay.config`

1. Princípio Central

O ServBay vem com pré-instalação de Node.js v12 a v23 de todas as versões principais no macOS (arm64/x86_64), permitindo que cada projeto vincule dinamicamente a versão necessária através de um arquivo de configuração.

Vantagens:
• Não é necessário instalar ou compilar manualmente, evitando conflitos de versão
• Suporte para execução simultânea de várias versões (por exemplo, projeto A usa Node 18, projeto B usa Node 22)
• Desacoplamento de serviços como PHP e bancos de dados, com ambiente de execução independente que não contamina o sistema

2. Passos de Configuração

Passo 1: Criar o arquivo de configuração
No diretório raiz do projeto, crie um arquivo .servbay.config e adicione o seguinte conteúdo:

bash

NODE_VERSION=20  # Define a versão do Node.js como 20.x  
# Opcional: configuração do mirror npm/pnpm (como aceleração na rede)  
YARN_CONFIG_REGISTRY=https://npmreg.proxy.ustclug.org/
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com  
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache

Passo 2: Verificar a eficácia da versão

bash

$ node -v  
v20.12.2  # Deve ser compatível com o arquivo de configuração  
$ npm run dev  # Resolução de dependências baseada na versão atual do Node

3. Funcionalidades Avançadas

• Coexistência de Múltiplas Versões: Ao alternar diretórios na mesma janela do terminal, o Node.js correspondente é carregado automaticamente
• Gerenciamento de Cache: Especificando o diretório de cache através de NPM_CONFIG_CACHE, evitando a contaminação global
• Suporte a Ferramentas: Gerenciadores de pacotes como npm, pnpm, yarn estão embutidos, com versões estritamente correspondentes ao Node.js

Exemplos de Execução

Abaixo, usamos um exemplo prático para demonstrar o mecanismo de funcionamento do .servbay.config.

Guia para Configuração Independente de Versões do Node.js com ServBay ​

Controle de Versão a Nível de Projeto com .servbay.config ​

1. Princípio Central ​

2. Passos de Configuração ​

3. Funcionalidades Avançadas ​