使用 ServBay 為專案獨立配置 Node.js 版本指南

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 文件，添加以下內容：

bash

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

步驟二：驗證版本生效

bash

$ node -v  
v20.12.2  # 應與配置文件一致  
$ npm run dev  # 依賴解析基於當前 Node 版本

3. 高級功能

• 多版本共存：同一終端窗口切換目錄時，自動加載對應版本的 Node.js
• 快取管理：透過 NPM_CONFIG_CACHE 指定快取目錄，避免全域污染
• 工具鏈支持：內建 npm、pnpm、yarn 等包管理器，版本與 Node.js 嚴格匹配

運行例子

下面使用實際例子演示.servbay.config的運作機制。

使用 ServBay 為專案獨立配置 Node.js 版本指南 ​

透過 .servbay.config 實現專案級版本控制 ​

1. 核心原理 ​

2. 配置步驟 ​

3. 高級功能 ​