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

نفدت ذاكرة جافاسكربت (heap out of memory)

تعطّل عملك

ما قد تراه

ينهار البناء أو خادم التطوير برسالة ذاكرة طويلة
يصبح أبطأ فأبطأ ثم يموت

السبب الأرجح

تحتاج العملية ذاكرة أكثر مما يسمح به Node افتراضياً: مشروع كبير جداً أو استيراد ضخم أو حلقة لا تنتهي تضيف بيانات.

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

هل يموت عند النقطة نفسها كل مرة (حلقة) أم في المشاريع الكبيرة فقط (حجم حقيقي)؟

أمر الإصلاح

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

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

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

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

لغة الأمر

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

المشكلة
نفدت ذاكرة جافاسكربت (heap out of memory)

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

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

السبب الأرجح
تحتاج العملية ذاكرة أكثر مما يسمح به Node افتراضياً: مشروع كبير جداً أو استيراد ضخم أو حلقة لا تنتهي تضيف بيانات.

نفّذ هذه الخطوات بهذا الترتيب
1. اعثر على ما كان يعمل عندما مات (آخر أسطر قبل الانهيار).
2. ابحث عن حلقة لا تنتهي أو ملف أو صورة ضخمة تُقرأ في الذاكرة؛ وأصلح ذلك أولاً.
3. إن كان المشروع كبيراً فعلاً فأرني كيف أرفع الحد لهذا الأمر فقط (NODE_OPTIONS=--max-old-space-size=4096) دون تغيير الجهاز.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

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

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

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

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

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

الخطوات

اعثر على ما كان يعمل عندما مات (آخر أسطر قبل الانهيار).
ابحث عن حلقة لا تنتهي أو ملف أو صورة ضخمة تُقرأ في الذاكرة؛ وأصلح ذلك أولاً.
إن كان المشروع كبيراً فعلاً فأرني كيف أرفع الحد لهذا الأمر فقط (NODE_OPTIONS=--max-old-space-size=4096) دون تغيير الجهاز.

لا تفعل هذا

لا تضبط الذاكرة على رقم ضخم دون سبب.
لا تحذف ميزات لتوفير الذاكرة.