التثبيت مع Volta | دورة Node.js

ما هو Volta؟

Volta هي أداة حديثة وقوية لإدارة نسخ Node.js وأدوات JavaScript الأخرى. تم تطويرها بواسطة LinkedIn وهي مكتوبة بلغة Rust، مما يجعلها سريعة وموثوقة للغاية.

لماذا Volta بدلاً من التثبيت المباشر؟

Volta تسمح لك بإدارة نسخ مختلفة من Node.js لمشاريع مختلفة، والتبديل بينها تلقائياً. كما أنها تضمن أن جميع أعضاء الفريق يستخدمون نفس النسخ الدقيقة من الأدوات، مما يقلل من مشاكل "يعمل على جهازي" الشهيرة!

مميزات Volta:

سرعة فائقة: مكتوبة بلغة Rust لأداء ممتاز
تبديل تلقائي: تنتقل تلقائياً للنسخة الصحيحة عند الانتقال بين المشاريع
إدارة سهلة: أوامر بسيطة وواضحة
عمل فريقي أفضل: ضمان توافق النسخ في الفريق
آمنة: لا تحتاج صلاحيات مدير النظام

التثبيت على Windows

الطريقة 1: باستخدام المثبت الرسمي (موصى به)

أسهل طريقة لتثبيت Volta على Windows هي استخدام المثبت الرسمي:

توجه إلى الموقع الرسمي: https://volta.sh
اضغط على "Get Started" أو "Download for Windows"
قم بتحميل ملف volta-setup.exe
شغل المثبت واتبع التعليمات
أعد تشغيل PowerShell أو Command Prompt

ملاحظة

قد تحتاج إلى إعادة تشغيل الكمبيوتر بالكامل لكي تعمل Volta بشكل صحيح.

الطريقة 2: باستخدام Chocolatey

إذا كنت تستخدم Chocolatey (مدير حزم Windows):

choco install volta

التحقق من التثبيت:

بعد التثبيت، افتح PowerShell أو CMD واكتب:

volta --version

يجب أن ترى رقم النسخة مثل 1.1.1 أو أحدث.

التثبيت على macOS

الطريقة 1: باستخدام cURL (موصى به)

افتح Terminal واكتب:

curl https://get.volta.sh | bash

ثم أعد تشغيل Terminal أو قم بتحميل إعدادات الـ shell:

source ~/.zshrc
# أو إذا كنت تستخدم bash
source ~/.bashrc

الطريقة 2: باستخدام Homebrew

إذا كنت تستخدم Homebrew:

brew install volta

التحقق من التثبيت:

volta --version

التثبيت على Linux

طريقة التثبيت القياسية:

افتح Terminal واكتب:

curl https://get.volta.sh | bash

ثم أعد تحميل إعدادات الـ shell:

source ~/.bashrc
# أو
source ~/.zshrc

تنبيه للمستخدمي Linux

تأكد من أن لديك curl مثبت على نظامك. يمكنك تثبيته باستخدام:

# Ubuntu/Debian
sudo apt install curl

# Fedora/RHEL
sudo dnf install curl

# Arch Linux
sudo pacman -S curl
                        

تثبيت Node.js باستخدام Volta

الآن بعد تثبيت Volta، يمكننا تثبيت Node.js بسهولة. Volta ستقوم تلقائياً بتثبيت أحدث نسخة LTS (Long Term Support) من Node.js:

volta install node

هذا الأمر سيقوم بـ:

تحميل أحدث نسخة LTS من Node.js
تثبيتها وإعدادها تلقائياً
تحديث متغيرات البيئة
تثبيت npm (مدير حزم Node.js) معها

تثبيت نسخة محددة:

إذا أردت تثبيت نسخة معينة من Node.js:

# تثبيت النسخة 20
volta install node@20

# تثبيت نسخة محددة بالضبط
volta install node@20.10.0

نصيحة احترافية

نسخ LTS (Long Term Support) هي النسخ الموصى بها للاستخدام في المشاريع الإنتاجية. تحصل على دعم وتحديثات أمنية لمدة طويلة. النسخ الحالية (Current) تحتوي على أحدث المميزات لكنها قد تكون أقل استقراراً.

التحقق من التثبيت

بعد تثبيت Node.js، دعنا نتأكد من أن كل شيء يعمل بشكل صحيح:

1. التحقق من Node.js:

node --version
# أو
node -v

يجب أن ترى رقم النسخة مثل: v20.10.0

2. التحقق من npm:

npm --version
# أو
npm -v

يجب أن ترى رقم النسخة مثل: 10.2.3

3. اختبار سريع - أول برنامج Node.js:

لنتأكد أن Node.js تعمل بشكل صحيح، سننشئ برنامجاً بسيطاً:

# أنشئ مجلد اختبار
mkdir test-nodejs
cd test-nodejs

# أنشئ ملف JavaScript
echo "console.log('مرحباً من Node.js!');" > hello.js

# شغل البرنامج
node hello.js

يجب أن ترى الرسالة: مرحباً من Node.js!

تهانينا!

لقد قمت بتشغيل أول برنامج Node.js لك! هذه بداية رحلتك في عالم تطوير الخادم باستخدام JavaScript.

أوامر Volta الأساسية

إليك أهم أوامر Volta التي ستحتاجها:

الأمر	الوصف
`volta install node`	تثبيت Node.js
`volta install npm`	تثبيت npm
`volta list`	عرض الأدوات المثبتة
`volta pin node@20`	تثبيت نسخة Node.js لمشروع معين
`volta --help`	عرض المساعدة

تثبيت نسخة لمشروع محدد (Project Pinning):

من أقوى مميزات Volta أنك تستطيع تحديد نسخة Node.js لكل مشروع:

# داخل مجلد المشروع
cd your-project
volta pin node@20.10.0

# سيتم حفظ النسخة في package.json

الآن، في أي وقت تدخل لهذا المشروع، Volta ستستخدم النسخة المحددة تلقائياً! 🎯

حل المشاكل الشائعة

المشكلة: الأمر volta غير موجود

الحل:

أعد تشغيل Terminal/PowerShell بالكامل
تأكد من إكمال عملية التثبيت بنجاح
على Windows: أعد تشغيل الكمبيوتر
على macOS/Linux: تأكد من تشغيل source ~/.bashrc

المشكلة: بطء في التحميل

الحل:

تحقق من اتصالك بالإنترنت
قد يستغرق التحميل وقتاً في المرة الأولى (ملفات كبيرة)
استخدم VPN إذا كان هناك حجب للموقع في بلدك

المشكلة: Permission Denied على Linux/macOS

الحل:

لا تستخدم sudo مع Volta
تأكد من ملكيتك للمجلد ~/.volta
تحقق من الصلاحيات: ls -la ~/.volta

الخلاصة

Volta هي أداة حديثة لإدارة نسخ Node.js
يمكن تثبيتها على Windows و macOS و Linux بسهولة
تستخدم volta install node لتثبيت Node.js
Volta تدير النسخ تلقائياً لكل مشروع
تدعم تثبيت نسخ متعددة والتبديل بينها بسهولة
مثالية للعمل الجماعي والمشاريع الكبيرة