Skip to content

الأسئلة الشائعة حول nvm-sh (FAQ)

إصدار Linux/macOS

أضف إلى ~/.bashrc أو ~/.zshrc:

bash
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

لقد قمت بتثبيت NVM، لكن الأمر nvm لا يعمل

قد يكون هذا بسبب عدة أسباب:

  1. متغيرات البيئة غير معدة بشكل صحيح: تأكد من إضافة دليل NVM إلى PATH الخاص بك
  2. الحاجة إلى إعادة تشغيل الطرفية: بعد التثبيت، أغلق وأعد فتح الطرفية أو موجه الأوامر
  3. ملف التكوين غير محدث: تحقق مما إذا كان ملف تكوين bash الخاص بك (.bashrc, .bash_profile, .zshrc, إلخ) يتضمن رمز تهيئة NVM

مشاكل الاستخدام

إصدار Node.js يعود إلى الافتراضي في كل مرة أفتح فيها طرفية جديدة

يحدث هذا لأن NVM يحمل الإصدار الافتراضي في كل جلسة طرفية جديدة. لحل هذه المشكلة، يمكنك:

  1. تعيين إصدار افتراضي لـ Node.js:

    bash
    nvm alias default 14.17.0
  2. إنشاء ملف .nvmrc في دليل المشروع الخاص بك وتنفيذ nvm use في دليل المشروع

الحزم المثبتة عالميًا تختفي بعد تبديل إصدار Node.js

هذا هو السلوك الطبيعي لـ NVM. لكل إصدار من Node.js مجموعته الخاصة المنفصلة من الحزم العالمية. عند تبديل الإصدارات، يمكنك الوصول فقط إلى الحزم العالمية المثبتة للإصدار الحالي.

تشمل الحلول:

  1. تثبيت الحزم العالمية بشكل منفصل في كل إصدار من Node.js تحتاجه
  2. استخدام الأمر nvm reinstall-packages لنسخ الحزم من إصدار إلى آخر

أخطاء SSL عند استخدام nvm install

إذا واجهت مشاكل مع شهادات SSL، يمكنك تجربة الطرق التالية:

bash
# Windows
nvm install 14.17.0 --insecure

# Linux/macOS
NVM_NODEJS_ORG_MIRROR=http://nodejs.org/dist nvm install 14.17.0

خطأ أثناء تثبيت إصدار Node.js على macOS

أنت تواجه خطأ في تجميع وحدة Node.js، والذي يحدث عادة عند تنفيذ npm install أو yarn install. رسالة الخطأ المحددة:

bash
# الخطأ:
/,nym/,cache/src/node-y14.18.0/files/out/Release/obj.target/v8 zlib/deps/v8/third party/zlib/zutil.o] Error 1
make[1]: *** [/Users/.../zutil.o] Error 1

هذا يشير إلى فشل في تجميع مكتبة zlib لمحرك V8 JavaScript الذي تعتمد عليه وحدات Node.js.

الحل:

bash
# تثبيت Xcode Command Line Tools
xcode-select --install

# تثبيت Homebrew (إذا لم يكن مثبتًا)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# تثبيت Python (Python 3 موصى به)
brew install python

كيفية إلغاء تثبيت NVM؟

Linux/macOS

  1. احذف دليل NVM: rm -rf "$NVM_DIR"
  2. قم بإزالة الأسطر المتعلقة بـ NVM من ملفات تكوين الشل الخاصة بك (.bashrc, .bash_profile, .zshrc, إلخ)، راجع دليل التثبيت للتفاصيل

بُني باستخدام VitePress