إصلاح · Node وnpm والبناء

الخطأ Cannot find module (وحدة غير موجودة)

ما قد تراه

ينهار التطبيق عند البدء مع Cannot find module
بدأ بعد أن سحبت تغييرات أو نقلت ملفات

السبب الأرجح

الحزمة غير مثبتة (أو غير مذكورة في package.json) أو أن مسار الملف في الـ import خاطئ.

افحص أولاً (نحو دقيقتين)

هل الاسم بين علامات الاقتباس حزمة (مثل express) أم مسار ملف (مثل ./utils)؟
للحزمة تحقق هل تظهر في package.json وفي node_modules.

أمر الإصلاح

ما تكتبه هنا لا يغادر متصفحك. البحث يعمل داخل هذه الصفحة ولا يُرسل شيء إلى خادم ولا إلى ذكاء اصطناعي.

نص الخطأ بالضبط أو ما تراه

ما فعلته قبل أن يحدث

يبقى في هذا المتصفح وعلى هذا الجهاز فقط. تُحذف المفاتيح وكلمات المرور قبل أي حفظ.

لغة الأمر

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

المشكلة
الخطأ Cannot find module (وحدة غير موجودة)

نص الخطأ كما ظهر لي، أو ما أراه
[الصق هنا نص الخطأ كما ظهر لك]

ما فعلته قبل أن تحدث المشكلة
[اكتب بإيجاز ما فعلته قبل ظهور المشكلة]

السبب الأرجح
الحزمة غير مثبتة (أو غير مذكورة في package.json) أو أن مسار الملف في الـ import خاطئ.

نفّذ هذه الخطوات بهذا الترتيب
1. اعثر على الـ import المذكور في الخطأ وأخبرني هل هو حزمة أم ملف.
2. لحزمة: تحقق أنه اسم حزمة حقيقي (تخترع أدوات الذكاء الاصطناعي أسماء أحياناً)؛ وإن كان حقيقياً فشغّل npm install <name> ليُحفظ في package.json.
3. لملف: أصلح المسار وحالة الأحرف والامتداد الذي يتطلبه أسلوب المشروع.
4. شغّل التطبيق من جديد.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- يبدأ التطبيق دون خطأ وحدة ويعرض npm ls <name> الحزمة.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

لا تغيّر
- لا تثبّت حزمة لا تجدها في قائمة الحزم الرسمية.
- أي شيء لم أطلبه: التصميم أو النصوص أو الصفحات الأخرى أو الإعدادات الأخرى أو البيانات.
- لا تحذف ملفات أو بيانات أو فروعاً، ولا تعِد الضبط ولا تدفع بالقوة (force push)، ولا تعيد كتابة السجل، إلا بعد أن تعرض عليّ بالضبط ما الذي سيضيع وأوافق.
- لا تلصق ولا تطبع ولا تطلب مني لصق كلمة مرور أو مفتاح سري في هذه المحادثة. وإذا لزم أحدها فأخبرني في أي صفحة إعدادات من الخدمة الصحيحة أحفظه.

عند الانتهاء
اشرح بكلمات بسيطة ما الذي غيّرته (ملفاً ملفاً أو إعداداً إعداداً) ولماذا غيّرته وكيف أتراجع عنه.

الصقه في Claude أو ChatGPT أو Gemini أو Cursor ثم اتبع ما يقوله.

بعد أن جرّبته، هل نجح؟

الخطوات

اعثر على الـ import المذكور في الخطأ وأخبرني هل هو حزمة أم ملف.
لحزمة: تحقق أنه اسم حزمة حقيقي (تخترع أدوات الذكاء الاصطناعي أسماء أحياناً)؛ وإن كان حقيقياً فشغّل npm install <name> ليُحفظ في package.json.
لملف: أصلح المسار وحالة الأحرف والامتداد الذي يتطلبه أسلوب المشروع.
شغّل التطبيق من جديد.

لا تفعل هذا

لا تحذف node_modules كخطوة أولى.
لا تثبّت حزمة لا تجدها في قائمة الحزم الرسمية.