الأسئلة الشائعة حول nvm-windows (FAQ)
المشاكل الشائعة والحلول عند تثبيت NVM. NVM (مدير إصدارات نود) هي أداة لإدارة إصدارات Node.js، ولكن قد تواجه بعض المشاكل أثناء التثبيت والاستخدام. تلخص هذه المقالة المشاكل الشائعة التي قد تواجهها عند تثبيت NVM وتقدم حلولاً مفصلة.
مشاكل عامة
- عدم إلغاء تثبيت Node.js قبل تثبيت nvm، مما يتسبب في عدم توفر node و npm بعد تثبيت nvm.
- بعد تثبيت Node.js باستخدام nvm لأول مرة، تذكر استخدام
nvm use
لتغيير إصدار Node.js وnvm on
لتمكين التحكم في إصدار Node.js، وإلا لن يكون node و npm متاحين.
- بعد تثبيت Node.js باستخدام nvm لأول مرة، تذكر استخدام
- بعد تثبيت npm بشكل عام، تحتاج إلى إغلاق نافذة الطرفية وإعادة فتحها قبل أن تتمكن من تثبيت cnpm.
- عند اختيار مجلد التثبيت لـ nvm، تجنب أسماء المجلدات التي تحتوي على أحرف صينية أو مسافات.
أوامر NVM غير معروفة في PowerShell
بشكل افتراضي، يمكن استخدام أوامر NVM فقط في موجه الأوامر (CMD) ولا يتم التعرف عليها مباشرة في PowerShell. هذا لأن سياسة التنفيذ في PowerShell تقيد تنفيذ البرامج النصية.
وصف المشكلة:
عند إدخال الأمر nvm
في PowerShell، يظهر "الأمر غير معروف".
الحل:
- تحقق من سياسة التنفيذ الحالية:
أدخل الأمر التالي في PowerShell للتحقق من سياسة التنفيذ للمستخدم الحالي
Get-ExecutionPolicy -List
- قم بتعديل سياسة التنفيذ: قم بتغيير سياسة التنفيذ للمستخدم الحالي إلى RemoteSigned للسماح بتنفيذ البرامج النصية المحلية:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
- تحقق مما إذا كان يعمل: أعد فتح PowerShell وحاول تنفيذ الأمر nvm للتأكد من عمله.
خطأ بعد تثبيت Node.js
بعد تثبيت nvm، إذا اكتشفت أنك لا تستطيع استخدام إصدار معين من Node.js وتلقيت خطأ، فقد لا تتمكن من استخدام أمر npm. قد يكون هذا بسبب تثبيت Node.js أثناء عملية التنزيل، لكن فشل تثبيت npm.
الحل:
- قم بتنزيل حزمة Node.js المضغوطة مباشرة من الموقع الرسمي لـ Node.js.
- قم بإلغاء تثبيت إصدار Node.js وإعادة تثبيته. أي، قم بتنفيذ
nvm uninstall xxxx
ثمnvm install xxx
مرة أخرى. - حاول تثبيت إصدار مختلف من Node.js.
nvm use لا يعمل
قم بإنشاء مجلد node.js في دليل nvm. (ملاحظة: يجب علينا تعديل خصائص مجلد nvm ومجلد nodejs، وتعيين أذونات التحكم الكامل في علامة التبويب "الخصائص -> الأمان")
مشكلة node -v لا تعمل
قم بتعديل معلمات مسار متغير البيئة، مع توجيه NVM_SYMLINK إلى مسار node.js الذي تم إنشاؤه حديثًا. (كما هو موضح في الصورة أدناه، هناك مكانان، في الأعلى والأسفل)
ما هو الفرق بين NVM والتثبيت المباشر لـ Node.js؟
يتيح لك NVM تثبيت وإدارة إصدارات متعددة من Node.js على نفس النظام، بينما يسمح التثبيت المباشر لـ Node.js بإصدار واحد فقط. باستخدام NVM، يمكنك التبديل بسهولة بين الإصدارات المختلفة، وهو أمر مفيد لاختبار التوافق أو العمل مع المشاريع التي تتطلب إصدارات محددة من Node.js.
هل NVM متعدد المنصات؟
تم تصميم NVM الأصلي (nvm-sh/nvm) بشكل أساسي لأنظمة Unix (Linux، macOS). بالنسبة لنظام Windows، هناك تطبيق منفصل يسمى nvm-windows، والذي يوفر وظائف مماثلة ولكن ليست متطابقة. هناك اختلافات دقيقة في الأوامر والسلوك بين الاثنين.
أي إصدار من NVM يجب أن أختار؟
- إذا كنت تستخدم Windows، يجب أن تختار nvm-windows
- إذا كنت تستخدم Linux أو macOS، يجب أن تختار nvm-sh/nvm الأصلي
- إذا كنت تستخدم WSL (نظام Windows الفرعي لـ Linux) على Windows، يجب عليك تثبيت nvm-sh/nvm الأصلي في بيئة WSL
مشاكل التثبيت
"خطأ وقت التشغيل R6034" بعد تثبيت NVM على Windows
هذا الخطأ مرتبط عادة بتعارضات وقت تشغيل Visual C++. جرب الحلول التالية:
- أعد تثبيت nvm-windows
- تأكد من أن لديك أحدث إصدار من حزمة Visual C++ Redistributable
- حاول تشغيل موجه الأوامر كمسؤول
تثبيت بطيء أو فاشل باستخدام المصادر الوطنية
إذا كنت في البر الرئيسي للصين، قد تحتاج إلى تكوين مصادر المرآة:
إصدار Windows
nvm npm_mirror https://npmmirror.com/mirrors/npm/
nvm node_mirror https://npmmirror.com/mirrors/node/