Module not found: Can't resolve ترجمتها «الوحدة غير موجودة: ما قدر يحدّد مكانها». معناها: الكود يطلب ملف أو مكتبة، وأداة البناء دوّرت عليه في المكان المكتوب وما لقته. والمسار بين علامتي التنصيص في الرسالة هو اللي ما انلقى.
الترجمة، والأشكال اللي تطلع فيها
| الرسالة | الترجمة | وين تشوفها |
|---|---|---|
Module not found: Can't resolve './components/Header' | الوحدة غير موجودة: ما قدر يلقى المسار | Next.js و webpack، أغلب مشاريع v0 |
Failed to resolve import "..." from "src/App.tsx". Does the file exist? | فشل تحديد مكان الاستيراد. هل الملف موجود؟ | Vite وقت التطوير، أغلب مشاريع Lovable و Bolt |
Rollup failed to resolve import أو Rolldown failed to resolve import | أداة البناء فشلت تحديد مكان الاستيراد | Vite وقت البناء |
Cannot find module | ما قدر يلقى الوحدة | Node.js |
كلمة module هنا تعني ملف من ملفات منتجك أو مكتبة خارجية، و resolve يعني «يلقى مكانه».
وين تشوفها، وليش ما تطلع بالعربي
تطلع في سجل البناء لما النشر يفشل، أو في صفحة التطوير نفسها. ورسائل أدوات البناء ما تتترجم، فبتشوفها بالإنجليزي دائمًا.
مشكلتك ولا مشكلة الموقع؟
- إذا أنت زائر: ما تشوفها. الموقع يبقى على آخر نسخة نجحت.
- إذا الموقع موقعك: اقرأ المسار في الرسالة أول. إذا يبدأ بـ ./ أو ../ فهو ملف من منتجك. إذا يبدأ بـ @/ فهو اختصار لمجلد. وإذا اسم بدون نقطة، مثل axios، فهو مكتبة خارجية. كل نوع له سبب مختلف.
علامة سريعة: إذا يشتغل على جهازك ويفشل في النشر، أشهر سبب فرق حرف كبير وصغير في اسم الملف، مثل Header و header. ويندوز وماك يعتبرونها نفس الملف، وسيرفر البناء لا.
إيش تكتب لـ Lovable أو Bolt أو Cursor
أحيانًا الأداة تحذف سطر الاستيراد، أو تنشئ ملف فاضي بنفس الاسم عشان البناء ينجح. البناء ينجح، والجزء اللي كان يستخدم الملف صار ناقص. انسخ الرسالة كاملة، وبعدها هذا:
The build fails with: <paste the full "Module not found" / "Failed to resolve import" line>.
The missing path is <path>, imported from <file>.
Find where the original file or package is: check the exact upper/lower case of the
file name in the repository, whether the file was committed, whether the package is in
package.json, and whether the @/ alias is set in both tsconfig and the build config.
Do not delete the import and do not create an empty file to make the build pass.الحل خطوة بخطوة
الأسباب الأربعة بالتفصيل، وكيف تصلّح اسم الملف عن طريق Git لأن تغيير الاسم العادي ما يكفي، في درس Module not found: Can't resolve: ليش البناء ما يلقى الملف؟. وإذا البناء يفشل برسالة ثانية، شوف Command "npm run build" exited with 1.
وإذا المشكلة واضحة ووحدة، تكفيك استشارة تقنية: نلقى السبب ونصلّحه معك على المكالمة.