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