البدء السريع

تثبيت Volta

تثبيت Unix

على معظم أنظمة Unix (بما في ذلك macOS)، يمكنك تثبيت Volta بأمر واحد:

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

لـ bash و zsh و fish، سيقوم برنامج التثبيت هذا بتحديث سكريبت بدء وحدة التحكم تلقائيًا. إذا كنت ترغب في منع تعديل سكريبت بدء وحدة التحكم، راجع تخطي إعداد Volta. لتكوين shell الخاص بك يدويًا لاستخدام Volta، حرر سكريبت بدء وحدة التحكم:

• اضبط متغير VOLTA_HOME على $HOME/.volta
• أضف $VOLTA_HOME/bin إلى بداية متغير PATH الخاص بك

تثبيت Windows

لـ Windows، يُنصح باستخدام winget لتثبيت Volta:

winget install Volta.Volta

إذا كنت ترغب، يمكنك أيضًا تحميل برنامج التثبيت وتشغيله يدويًا لتثبيت Volta.

نظام Windows الفرعي لـ Linux

إذا كنت تستخدم Volta في نظام Windows الفرعي لـ Linux، اتبع دليل تثبيت Unix أعلاه.

التثبيت اليدوي

إذا كنت ترغب في تثبيت Volta يدويًا، يمكنك تحميل الحزمة المناسبة لنظام التشغيل من الجدول أدناه:

المنصة	الحزمة وتعليمات التثبيت
Windows x86_64	volta-2.0.2-windows-x86_64.msi انقر نقرًا مزدوجًا على ملف MSI واتبع معالج التثبيت. سيقوم برنامج التثبيت بإضافة Volta إلى PATH الخاص بك تلقائيًا.
Windows ARM64	volta-2.0.2-windows-arm64.msi انقر نقرًا مزدوجًا على ملف MSI واتبع معالج التثبيت. سيقوم برنامج التثبيت بإضافة Volta إلى PATH الخاص بك تلقائيًا.
Windows x86_64 (ZIP)	volta-2.0.2-windows.zip استخرج ملف ZIP إلى الموقع الذي تختاره. أضف الدليل المستخرج إلى متغير البيئة PATH الخاص بك.
Windows ARM64 (ZIP)	volta-2.0.2-windows-arm64.zip استخرج ملف ZIP إلى الموقع الذي تختاره. أضف الدليل المستخرج إلى متغير البيئة PATH الخاص بك.
macOS x86_64/ARM64	volta-2.0.2-macos.tar.gz استخرج tarball وشغل سكريبت التثبيت المرفق: tar xzf volta-2.0.2-macos.tar.gz && ./volta-2.0.2-macos/install.sh
Linux x86_64	volta-2.0.2-linux.tar.gz استخرج tarball وشغل سكريبت التثبيت المرفق: tar xzf volta-2.0.2-linux.tar.gz && ./volta-2.0.2-linux/install.sh
Linux ARM	volta-2.0.2-linux-arm.tar.gz استخرج tarball وشغل سكريبت التثبيت المرفق: tar xzf volta-2.0.2-linux-arm.tar.gz && ./volta-2.0.2-linux-arm/install.sh

خطوات التثبيت اليدوي لـ Windows

1. حمل برنامج التثبيت MSI المناسب لبنية نظامك (x86_64 أو ARM64)
2. انقر نقرًا مزدوجًا على الملف المحمل لتشغيل برنامج التثبيت
3. اتبع توجيهات معالج التثبيت
4. سيقوم برنامج التثبيت بإضافة Volta إلى PATH الخاص بنظامك تلقائيًا
5. افتح نافذة موجه أوامر أو PowerShell جديدة لبدء استخدام Volta

طريقة التثبيت بـ ZIP:

1. حمل ملف ZIP المناسب لبنية نظامك
2. استخرج ملف ZIP إلى الدليل الذي تختاره (مثل، C:\Program Files\Volta)
3. أضف الدليل المستخرج إلى متغير البيئة PATH الخاص بنظامك
4. افتح نافذة موجه أوامر أو PowerShell جديدة لبدء استخدام Volta

خطوات التثبيت اليدوي لـ macOS

1. حمل macOS tarball
2. افتح Terminal وانتقل إلى موقع التحميل
3. استخرج tarball وشغل سكريبت التثبيت:

   tar xzf volta-2.0.2-macos.tar.gz
   ./volta-2.0.2-macos/install.sh

4. سيقوم سكريبت التثبيت بـ:
   • وضع ملفات Volta الثنائية في ~/.volta/bin
   • تحديث ملف تكوين shell الخاص بك لإضافة Volta إلى PATH
5. أعد تشغيل Terminal أو شغل source ~/.bashrc (أو ملف تكوين shell المناسب)

خطوات التثبيت اليدوي لـ Linux

1. حمل Linux tarball المناسب لبنية نظامك (x86_64 أو ARM)
2. افتح Terminal وانتقل إلى موقع التحميل
3. استخرج tarball وشغل سكريبت التثبيت:

   tar xzf volta-2.0.2-linux.tar.gz
   ./volta-2.0.2-linux/install.sh

4. سيقوم سكريبت التثبيت بـ:
   • وضع ملفات Volta الثنائية في ~/.volta/bin
   • تحديث ملف تكوين shell الخاص بك لإضافة Volta إلى PATH
5. أعد تشغيل Terminal أو شغل source ~/.bashrc (أو ملف تكوين shell المناسب)

اختيار إصدار Node الافتراضي

هذا هو الإصدار الذي يستخدمه Volta في كل مكان خارج المشاريع ذات الإصدارات المثبتة.

لاختيار إصدار محدد من Node، شغل:

volta install node@22.5.1

أو لاستخدام أحدث إصدار LTS، شغل:

volta install node

استخدام Volta لإدارة مشروعك

استخدام Volta في مشروعك بسيط. فقط شغل:

volta pin node@16

هذا سيضيف قسم volta إلى ملف package.json الخاص بك، مما يضمن استخدام جميع أعضاء المشروع نفس إصدار Node.js.

يمكنك أيضًا تثبيت مدير الحزم:

volta pin npm@8

بهذه الطريقة، كلما شغلت npm في مشروعك، سيضمن Volta استخدام الإصدار المحدد.