Руководство по независимой настройке версии Node.js для проектов с использованием ServBay

ServBay, как интегрированная среда разработки, нативно поддерживает параллельное управление несколькими версиями Node.js и быструю их смену, решая проблемы сложности и потребления ресурсов традиционных инструментов (таких как NVM или Docker). Ниже представлен полный план конфигурации для распространенных сценариев:

Реализация управления версиями на уровне проекта с помощью .servbay.config

1. Основной принцип

ServBay предустановил на macOS (arm64/x86_64) все основные версии Node.js с v12 по v23, каждая из которых может быть динамически связана с нужной версией через файл конфигурации для каждого проекта.

Преимущества:
• Нет необходимости вручную устанавливать или компилировать, что избегает конфликтов версий
• Поддержка одновременной работы нескольких версий (например, проект A использует Node 18, а проект B — Node 22)
• Разделение от таких услуг, как PHP и базы данных, независимая рабочая среда не загрязняет систему

2. Этапы настройки

Этап первый: создание файла конфигурации
Создайте файл .servbay.config в корневом каталоге проекта и добавьте следующее содержимое:

NODE_VERSION=20  # Указание версии Node.js 20.x  
# По желанию: настройка зеркала npm/pnpm (например, для ускорения сети)  
YARN_CONFIG_REGISTRY=https://npmreg.proxy.ustclug.org/
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com  
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache

Этап второй: проверка активной версии

$ node -v  
v20.12.2  # Должно совпадать с файлом конфигурации  
$ npm run dev  # Разрешение зависимостей основано на текущей версии Node

3. Расширенные возможности

• Совместное существование нескольких версий: при смене каталога в одном и том же терминальном окне автоматически загружается соответствующая версия Node.js
• Управление кешем: указание каталога для кеша через NPM_CONFIG_CACHE, избежание глобального загрязнения
• Поддержка инструментальных цепочек: встроенные менеджеры пакетов npm, pnpm, yarn и т.д., версия которых строго соответствует Node.js

Примеры работы

Ниже приведен реальный пример работы .servbay.config.