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

command not found: npm أو node أو next أو أداة أخرى

ما قد تراه

تقول الطرفية command not found
يعمل على جهاز آخر أو كان يعمل قبل أن أعيد التشغيل

السبب الأرجح

الأداة غير مثبتة، أو ليست في قائمة الأماكن التي تبحث فيها الطرفية (PATH)، أو هي أداة مشروع لم تُثبَّت قط بـ npm install.

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

شغّل node -v وnpm -v: هل يطبعان إصداراً؟
إن فشلت أداة مشروع فقط (next أو vite) فشغّل ls node_modules/.bin لترى هل هي موجودة.

أمر الإصلاح

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

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

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

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

لغة الأمر

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

المشكلة
command not found: npm أو node أو next أو أداة أخرى

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

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

السبب الأرجح
الأداة غير مثبتة، أو ليست في قائمة الأماكن التي تبحث فيها الطرفية (PATH)، أو هي أداة مشروع لم تُثبَّت قط بـ npm install.

نفّذ هذه الخطوات بهذا الترتيب
1. شغّل node -v وnpm -v وwhich node وecho $PATH واعرض عليّ المخرجات.
2. إن كان node أو npm ناقصاً فأخبرني كيف أثبّت Node من المصدر الرسمي أو من مدير إصدارات وانتظر موافقتي. لا تثبّت شيئاً بنفسك.
3. إن كانت أداة المشروع وحدها ناقصة فشغّل npm install في مجلد المشروع (حيث package.json) ثم شغّل الأداة بـ npm run <script> أو npx.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- يطبع node -v وnpm -v إصدارين ويبدأ npm run dev.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

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

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

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

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

الخطوات

شغّل node -v وnpm -v وwhich node وecho $PATH واعرض عليّ المخرجات.
إن كان node أو npm ناقصاً فأخبرني كيف أثبّت Node من المصدر الرسمي أو من مدير إصدارات وانتظر موافقتي. لا تثبّت شيئاً بنفسك.
إن كانت أداة المشروع وحدها ناقصة فشغّل npm install في مجلد المشروع (حيث package.json) ثم شغّل الأداة بـ npm run <script> أو npx.

لا تفعل هذا

لا تنسخ أوامر من موقع عشوائي تغيّر إعدادات النظام.
لا تستخدم sudo لتثبيت حزم المشروع.