الأسئلة الشائعة حول nvm-sh (FAQ)
إصدار Linux/macOS
أضف إلى ~/.bashrc أو ~/.zshrc:
bash
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
لقد قمت بتثبيت NVM، لكن الأمر nvm
لا يعمل
قد يكون هذا بسبب عدة أسباب:
- متغيرات البيئة غير معدة بشكل صحيح: تأكد من إضافة دليل NVM إلى PATH الخاص بك
- الحاجة إلى إعادة تشغيل الطرفية: بعد التثبيت، أغلق وأعد فتح الطرفية أو موجه الأوامر
- ملف التكوين غير محدث: تحقق مما إذا كان ملف تكوين bash الخاص بك (
.bashrc
,.bash_profile
,.zshrc
, إلخ) يتضمن رمز تهيئة NVM
مشاكل الاستخدام
إصدار Node.js يعود إلى الافتراضي في كل مرة أفتح فيها طرفية جديدة
يحدث هذا لأن NVM يحمل الإصدار الافتراضي في كل جلسة طرفية جديدة. لحل هذه المشكلة، يمكنك:
تعيين إصدار افتراضي لـ Node.js:
bashnvm alias default 14.17.0
إنشاء ملف
.nvmrc
في دليل المشروع الخاص بك وتنفيذnvm use
في دليل المشروع
الحزم المثبتة عالميًا تختفي بعد تبديل إصدار Node.js
هذا هو السلوك الطبيعي لـ NVM. لكل إصدار من Node.js مجموعته الخاصة المنفصلة من الحزم العالمية. عند تبديل الإصدارات، يمكنك الوصول فقط إلى الحزم العالمية المثبتة للإصدار الحالي.
تشمل الحلول:
- تثبيت الحزم العالمية بشكل منفصل في كل إصدار من Node.js تحتاجه
- استخدام الأمر
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
- احذف دليل NVM:
rm -rf "$NVM_DIR"
- قم بإزالة الأسطر المتعلقة بـ NVM من ملفات تكوين الشل الخاصة بك (
.bashrc
,.bash_profile
,.zshrc
, إلخ)، راجع دليل التثبيت للتفاصيل