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

process.env.X غير معرّف (لا تُقرأ قيمة .env)

ما قد تراه

قيمة من ملف .env غير معرّفة في التطبيق
غير معرّفة في المتصفح فقط

السبب الأرجح

اسم الملف أو المتغير ليس ما تقرؤه الأداة، أو لم يُعد تشغيل خادم التطوير، أو أن شيفرة المتصفح تحتاج البادئة العامة.

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

هل الملف في جذر المشروع (بجانب package.json) وباسم تتوقعه الأداة بالضبط؟
هل أوقفت خادم التطوير وشغّلته بعد التعديل؟

أمر الإصلاح

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

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

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

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

لغة الأمر

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

المشكلة
process.env.X غير معرّف (لا تُقرأ قيمة .env)

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

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

السبب الأرجح
اسم الملف أو المتغير ليس ما تقرؤه الأداة، أو لم يُعد تشغيل خادم التطوير، أو أن شيفرة المتصفح تحتاج البادئة العامة.

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

تأكد أن الحل نجح
- تُقرأ القيمة حيث يلزم (اختبر بقيمة بريئة مثل اسم الموقع وليس مفتاحاً).
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

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

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

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

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

الخطوات

اعرض أسماء الملفات (وليس المحتوى) في الجذر وأسماء المتغيرات التي تقرؤها الشيفرة.
اشرح قاعدة البادئة في هذا الإطار لشيفرة المتصفح وشيفرة الخادم، وأصلح الأسماء.
أخبرني أن أعيد تشغيل خادم التطوير؛ وتحقق أن .env مذكور في .gitignore.

لا تفعل هذا

لا تحفظ .env بـ commit.
لا تطبع قيم الأسرار الحقيقية.
لا تعطِ سراً بادئة عامة.