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

npm ERESOLVE: تعارض اعتماديات

ما قد تراه

يتوقف npm install مع unable to resolve dependency tree
يخبرني أن أستخدم --force أو --legacy-peer-deps

السبب الأرجح

تحتاج حزمتان إصدارين مختلفين من حزمة ثالثة، وغالباً بعد ترقية React أو Next.

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

اقرأ سطري "Found:" و"Could not resolve dependency": يذكران الحزم المتعارضة.

أمر الإصلاح

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

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

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

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

لغة الأمر

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

المشكلة
npm ERESOLVE: تعارض اعتماديات

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

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

السبب الأرجح
تحتاج حزمتان إصدارين مختلفين من حزمة ثالثة، وغالباً بعد ترقية React أو Next.

نفّذ هذه الخطوات بهذا الترتيب
1. اعرض التعارض وأي حزمة تطلب أي إصدار.
2. ابحث عن إصدار الحزمة القديمة الذي يدعم إصداري أو حزمة أحدث تدعمه.
3. فقط إن لم يوجد بديل آمن اشرح معنى --legacy-peer-deps واسألني قبل استخدامه.
4. شغّل npm install ثم البناء واختباراً سريعاً.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- ينتهي npm install ويُبنى التطبيق ويعمل.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

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

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

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

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

الخطوات

اعرض التعارض وأي حزمة تطلب أي إصدار.
ابحث عن إصدار الحزمة القديمة الذي يدعم إصداري أو حزمة أحدث تدعمه.
فقط إن لم يوجد بديل آمن اشرح معنى --legacy-peer-deps واسألني قبل استخدامه.
شغّل npm install ثم البناء واختباراً سريعاً.

لا تفعل هذا

لا تستخدم --force كجواب أول.
لا ترقِّ React أو Next أو الحزم الرئيسية إلى إصدارات رئيسية جديدة دون إخباري.