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

أخطاء ESLint تمنع البناء

ما قد تراه

يتوقف البناء على رسائل lint مثل متغير غير مستخدم
يبنى محلياً ويفشل على الاستضافة

السبب الأرجح

تشغّل الاستضافة مدقق الأسلوب ضمن البناء، وقاعدة واحدة لا تفشل محلياً أشد هناك.

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

شغّل npm run lint واقرأ أسماء القواعد في نهاية كل سطر.

أمر الإصلاح

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

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

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

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

لغة الأمر

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

المشكلة
أخطاء ESLint تمنع البناء

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

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

السبب الأرجح
تشغّل الاستضافة مدقق الأسلوب ضمن البناء، وقاعدة واحدة لا تفشل محلياً أشد هناك.

نفّذ هذه الخطوات بهذا الترتيب
1. شغّل أمر lint وجمّع الرسائل حسب القاعدة.
2. أصلح المشاكل الحقيقية (شيفرة غير مستخدمة ومفاتيح ناقصة وعلامات اقتباس خاطئة). وإن كانت قاعدة لا تناسب المشروع حقاً فاسألني قبل تغييرها.
3. أعد تشغيل lint والبناء.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- ينتهي npm run lint دون أخطاء وينجح بناء الاستضافة.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

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

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

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

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

الخطوات

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

لا تفعل هذا

لا تضف تعليقات تعطيل في كل مكان.
لا توقف lint للبناء كله.