إصلاح · فيرسل والنشر

يقول البناء "Module not found: Can't resolve"

ما قد تراه

يفشل البناء عند import يعمل على جهازي
اسم الملف بحروف كبيرة مختلفة عن الـ import

السبب الأرجح

يعدّ لينكس (الذي تستخدمه Vercel) الملفين Header.tsx وheader.tsx مختلفين، أو أن الحزمة غير مكتوبة في package.json، أو أن الملف لم يُحفظ في Git.

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

قارن نص الـ import باسم الملف الحقيقي حرفاً بحرف بما فيها الحروف الكبيرة.
شغّل git ls-files | grep -i <name> لترى هل عند Git الملف.

أمر الإصلاح

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

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

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

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

لغة الأمر

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

المشكلة
يقول البناء "Module not found: Can't resolve"

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

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

السبب الأرجح
يعدّ لينكس (الذي تستخدمه Vercel) الملفين Header.tsx وheader.tsx مختلفين، أو أن الحزمة غير مكتوبة في package.json، أو أن الملف لم يُحفظ في Git.

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

تأكد أن الحل نجح
- ينجح npm run build محلياً وينجح بناء Vercel.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

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

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

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

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

الخطوات

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

لا تفعل هذا

لا تحذف الـ import لتزول رسالة الخطأ.
لا تغيّر أسماء ملفات كثيرة دفعة واحدة.