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

Vite: قيمة import.meta.env غير معرّفة

ما قد تراه

يعمل المتغير في Node ولا يعمل في تطبيق Vite

السبب الأرجح

لا يعرض Vite إلا المتغيرات التي تبدأ أسماؤها بـ VITE_ ولا يقرؤها إلا عند بدء خادم التطوير.

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

هل يبدأ الاسم بـ VITE_ وهو في ملف .env في جذر المشروع؟

أمر الإصلاح

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

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

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

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

لغة الأمر

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

المشكلة
Vite: قيمة import.meta.env غير معرّفة

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

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

السبب الأرجح
لا يعرض Vite إلا المتغيرات التي تبدأ أسماؤها بـ VITE_ ولا يقرؤها إلا عند بدء خادم التطوير.

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

تأكد أن الحل نجح
- تظهر القيمة في التطبيق (اختبر بقيمة بريئة).
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

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

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

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

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

الخطوات

أعد تسمية المتغير بالبادئة في الملف وفي الشيفرة (import.meta.env.VITE_NAME) وأعد تشغيل خادم التطوير.
حذّرني أن كل ما له البادئة عام في المتصفح فلا مفاتيح سرية.
للإنتاج أضف الاسم نفسه في إعدادات الاستضافة وأعد النشر.

لا تفعل هذا

لا تستخدم process.env في شيفرة متصفح تطبيق Vite.
لا تستخدم VITE_ للمفاتيح السرية.