البناء ينجح على Windows ويفشل على خادم Linux

Case-sensitive Paths

خطأمتوسطالخطورة: متوسطةالنشر

خطأ Module not found أو Cannot find module عند البناء في المنصة فقط.

الأعراض

  • خطأ Module not found أو Cannot find module عند البناء في المنصة فقط.

السبب

نظام ملفات Windows وmacOS عادة لا يميز حالة الأحرف، بينما Linux يميزها. استيراد ./Button وملف اسمه button.jsx يعمل محلياً ويفشل على الخادم.

الحل

  • طابق حالة الأحرف في الاستيراد مع اسم الملف تماماً.
  • عند إعادة تسمية ملف بتغيير الحالة فقط استخدم git mv.

الوقاية

  • اتفاقية تسمية ثابتة في ملف السياق.
  • شغّل البناء في CI على Linux.