دليل استخدام ServBay لتكوين إصدار Node.js مستقل للمشاريع

يعتبر ServBay بيئة تطوير متكاملة تدعم بشكل أصلي الإدارة المتوازية والتحويل السريع بين إصدارات Node.js المتعددة، مما يحل مشاكل التعقيد واستهلاك الموارد التي تواجهها الأدوات التقليدية مثل NVM أو Docker. فيما يلي الحلول التكوينية الكاملة للسيناريوهات الشائعة:

تحقيق التحكم في الإصدار على مستوى المشروع من خلال .servbay.config

1. المبدأ الأساسي

قم بتثبيت جميع الإصدارات الرئيسية من Node.js v12 إلى v23 مسبقاً على نظام macOS (arm64/x86_64) بواسطة ServBay، بحيث يمكن لكل مشروع الربط ديناميكياً بالإصدار المطلوب من خلال ملف التكوين.

المزايا:
• لا حاجة للتثبيت أو التجميع اليدوي، مما يتجنب تعارض الإصدارات
• دعم التشغيل المتزامن للإصدارات المتعددة (مثل المشروع 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.