كيفية استكشاف أخطاء تثبيتات Node.js و npm وإصلاحها على نظامي التشغيل Windows و macOS

إذا سبق لك أن حاولت تشغيل مشروع ووجدت أن الطرفية لا تتعرف على الأوامر أو أن الحزم العامة قد تعطلت، فلا داعي للقلق. هذا الأمر أكثر شيوعًا مما قد تتصور. تثبيت Node.js و npm تتعرض هذه الملفات للتلف أو تسبب مشاكل، خاصة عندما ننتقل من إصدار إلى آخر أو عندما تصبح أذونات نظام التشغيل حساسة.

لترتيب هذا الفوضى، أول ما يجب فهمه هو أن Node.js هي البيئة التي تسمح لك بتشغيل جافا سكريبت خارج المتصفح، بينما npm مسؤول عن إدارة جميع المكتبات. عندما لا يتوافق هذان العنصران، فإن أفضل طريقة ليست محاولة "ترقيع" التثبيت الحالي، بل قم بتطبيق تنظيف عميق وأعد تثبيت البرنامج باستخدام أدوات تمنع تكرار المشكلة في المستقبل.

اختيار الإصدار المناسب: LTS أم الإصدار الحالي؟

قبل البدء في عملية الإصلاح، عليك أن تقرر المسار الذي ستسلكه. الإصدار LTS (الدعم طويل الأمد) إنه الخيار الآمن؛ إنه الخيار الذي يجب عليك استخدامه إذا كنت تبحث عن استقرار كامل في الإنتاج أو إذا كنت في بداية الطريق، لأنه تم اختباره على نطاق واسع ونادراً ما يسبب مفاجآت.

من ناحية أخرى ، لدينا الإصدار حالياًّهذا هو "الإصدار المتطور"، حيث تظهر أحدث الميزات. إنه مثالي للتجربة أو إذا كنت بحاجة إلى ميزة متطورة من إطار عمل، ولكن ضع في اعتبارك أن الدعم يكون أقصر، وأن هذا هو المكان الذي تظهر فيه الأخطاء غالبًا. الأخطاء أو عدم التوافق مع الحزم القديمة.

الإصلاح والتثبيت في نظام التشغيل ويندوز 11

عندما يفشل تثبيت Node.js على نظام ويندوز، فغالبًا ما يكون السبب مشكلة في المسار. إذا كنت قد استخدمت برنامج التثبيت الرسمي بصيغة .msi، فتأكد من تحديد خيار [أدخل الخيار هنا] أثناء عملية التثبيت. أضف Node إلى PATHإذا لم ينجح ذلك، فسيتعين عليك الانتقال يدويًا إلى خصائص النظام وإضافة المسارات إلى y %AppData%\npm في متغيرات بيئة المستخدم.

إذا كنت تفضل شيئًا أكثر حداثة ونظافة، أنصحك باستخدام الجناحوهي ميزة مدمجة بالفعل في نظامي التشغيل ويندوز 10 و11. باستخدام أمر بسيط مثل يمكنك تجهيز كل شيء بسهولة تامة. كما يوجد تطبيق Chocolatey، وهو بديل قوي للغاية لمحبي... أتمتة الحزم عبر سطر الأوامر.

أما بالنسبة لأولئك الذين يرغبون في تجنب مشاكل الأذونات وتغيير الإصدارات دون إحداث أي خلل، فإن الحل يُسمى نظام التشغيل ويندوز nvmإنه مشروع مختلف عن مشروع Linux/Mac الذي يسمح لك بتثبيت إصدارات متعددة من Node والتبديل بينها باستخدام منع الأدوات العالمية من أن تصبح غير مستقرة.

حلول لبيئات macOS و Unix

في نظام ماك، الطريقة الأكثر شيوعًا هي استخدام حزمة .pkg الرسمية، ولكن إذا كنت ترغب في الارتقاء بسير عملك إلى المستوى التالي، Homebrew هي الأداة نهائي. يسمح بتثبيت Node مع ويمكنك تحديثه بسهولة باستخدام مع ذلك، قد تحدث أحيانًا تعارضات في الروابط يتم حلها باستخدام الأمر .

لكن "الكأس المقدسة" الحقيقية في نظام macOS هي nvm (مدير إصدار العقدة)بتثبيت Node عبر nvm، تُحفظ الملفات في مجلد المستخدم الخاص بك وليس في مجلدات النظام المقيدة. هذا يحل المشكلة المزعجة تمامًا. أخطاء في أذونات EACCESمما يلغي الحاجة إلى استخدام الأمر لتثبيت الحزم العالمية.

إذا كنت تستخدم نظام لينكس (أوبونتو، ديبيان أو فيدورا)، فمن الأفضل استخدام البرامج النصية الخاصة بـ NodeSource للحصول على إصدارات LTS محدثة، تذكر أنه إذا كنت تستخدم نظام ويندوز الفرعي لنظام لينكس (WSL)، فمن الأفضل تثبيت Node مباشرةً داخل توزيعة لينكس وعدم دمج ملفات ويندوز الثنائية مع ملفات WSL الثنائية، لأن ذلك قد يسبب مشاكل. تعارضات الطرق مزعج للغاية.

استكشاف الأخطاء الشائعة وإصلاحها والصيانة

إذا كنت عند الكتابة سيخبرك الطرفية أن الأمر غير معروف؛ لا داعي للقلق. هذا يعني عادةً أن دليل npm العالمي bin الملف غير موجود في مسار النظام (PATH). على نظامي macOS وLinux، تأكد من وجود ملفك في المسار الصحيح. o يتم تحميل إعدادات nvm بشكل صحيح عند تسجيل الدخول، مما يمنع رفض المضيف المحلي الاتصال أو أعطال مماثلة في الخادم المحلي.

للحفاظ على بيئة صحية، لا يكفي مجرد تثبيت النظام وتركه. فالتنفيذ أمر ضروري. أحيانًا للكشف الثغرات الأمنية في قسمك. إذا لاحظت أن شيئًا ما قديم، سيخبرك البرنامج بالحزم التي تحتاج إلى تحديث عاجل.

إحدى الحيل التي يمكن للمطورين استخدامها npxبدلاً من ملء نظامك بتثبيتات عالمية قد تتعارض مع بعضها البعض، يتيح لك npx تشغيل واجهات سطر الأوامر مؤقتًا. بالإضافة إلى ذلك، إذا كنت بحاجة إلى إدارة pnpm أو Yarn، فقم بتمكينها. حزمة أساسية مع الأمر أن يكون لديك سيطرة كاملة على مديري الحزم.

لترك النظام نظيفًا قبل إعادة التثبيت، في نظام التشغيل ويندوز، يجب عليك ليس فقط حذف التطبيق من الإعدادات، ولكن أيضًا حذف المجلدات المتبقية يدويًا في على نظام ماك، إذا كنت تستخدم Homebrew، فـ عادةً ما يكون ذلك كافياً، على الرغم من أن تنظيف ذاكرة التخزين المؤقت لـ npm مع من الأفضل دائماً منع تكرار الأخطاء القديمة.

يتطلب الحفاظ على بيئة تطوير سليمة إعطاء الأولوية دائمًا لإصدارات الدعم طويل الأمد (LTS)، وتفويض إدارة الإصدارات إلى أدوات مثل NVM أو FNM، وتجنب استخدام صلاحيات المسؤول لتثبيت المكتبات بأي ثمن. من خلال ضبط متغيرات البيئة بشكل صحيح وتنظيف الملفات المؤقتة، نضمن تشغيل Node.js وnpm بسلاسة على أي نظام تشغيل.

مقالة ذات صلة:

إصلاح رفض المضيف المحلي خطأ الاتصال في نظام التشغيل Windows

إسحاق

كاتب شغوف بعالم البايت والتكنولوجيا بشكل عام. أحب مشاركة معرفتي من خلال الكتابة، وهذا ما سأفعله في هذه المدونة، لأعرض لك كل الأشياء الأكثر إثارة للاهتمام حول الأدوات الذكية والبرامج والأجهزة والاتجاهات التكنولوجية والمزيد. هدفي هو مساعدتك على التنقل في العالم الرقمي بطريقة بسيطة ومسلية.