Skip to content

أوامر CLI

يوفر Volta مجموعة غنية من أوامر سطر الأوامر لمساعدتك في إدارة سلسلة أدوات JavaScript.

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

volta install

تثبيت أداة في سلسلة الأدوات الخاصة بك.

bash
# تثبيت أحدث Node.js LTS
volta install node

# تثبيت إصدار محدد من Node.js
volta install node@16.14.2

# تثبيت أحدث npm
volta install npm

# تثبيت إصدار محدد من yarn
volta install yarn@1.22.19

# تثبيت حزمة عالميًا
volta install typescript
volta install @vue/cli

الخيارات:

  • --verbose: تمكين التشخيص المفصل
  • --quiet: منع المخرجات غير الضرورية

volta uninstall

إلغاء تثبيت أداة من سلسلة الأدوات الخاصة بك.

bash
# إلغاء تثبيت Node.js
volta uninstall node

# إلغاء تثبيت npm
volta uninstall npm

# إلغاء تثبيت حزمة
volta uninstall typescript

volta pin

تثبيت أداة في package.json لمشروعك.

bash
# تثبيت Node.js
volta pin node@16.14.2

# تثبيت npm
volta pin npm@8.5.0

volta list

سرد الأدوات المتاحة في سلسلة الأدوات الخاصة بك.

bash
# سرد جميع الأدوات
volta list all

# سرد إصدارات Node.js المثبتة
volta list node

# سرد مديري الحزم المثبتة
volta list npm
volta list yarn

# سرد الحزم المثبتة
volta list packages

volta which

عرض مسار الأداة المحددة التي سيستخدمها Volta.

bash
volta which node
volta which npm
volta which typescript

volta run

تشغيل أمر باستخدام إصدار مخصص من الأداة.

bash
# تشغيل باستخدام إصدار محدد من Node.js
volta run --node 14 node index.js

# تشغيل باستخدام إصدار محدد من npm
volta run --npm 6 npm install

# استخدام Node.js و npm مخصصين في نفس الوقت
volta run --node 14 --npm 6 npm install

الأوامر الإضافية

volta completions

إنشاء سكريبتات إكمال shell.

bash
# إنشاء إكمال bash
volta completions bash > volta.bash

# إنشاء إكمال zsh
volta completions zsh > _volta

# إنشاء إكمال fish
volta completions fish > volta.fish

volta setup

تكوين Volta في بيئتك.

bash
# إعداد Volta بالإعدادات الافتراضية
volta setup

# إعداد volta دون تعديل ملفات التكوين
VOLTA_SKIP_SETUP=1 volta setup

volta help

عرض مساعدة أوامر Volta.

bash
# المساعدة العامة
volta help

# مساعدة أمر محدد
volta help install
volta help pin

رموز الخروج

ترجع أوامر Volta رموز الخروج التالية:

  • 0: نجح
  • 1: خطأ عام
  • 2: خطأ في معاملات سطر الأوامر
  • أرقام أعلى: أخطاء خاصة بالأمر

متغيرات البيئة

هذه متغيرات البيئة تؤثر على سلوك Volta عند تشغيل الأوامر:

  • VOLTA_HOME: الدليل الذي يخزن فيه Volta البيانات
  • VOLTA_LOGLEVEL: مستوى تفصيل السجلات (error، warn، info، verbose، debug)
  • VOLTA_SKIP_SETUP: تخطي تعديل ملفات تكوين shell أثناء الإعداد
  • VOLTA_FEATURE_PNPM: تمكين دعم pnpm