كيفية حل مشكلة "'node' is not recognized as an internal or external command"

يظهر الخطأ 'node' is not recognized as an internal or external command, operable program or batch file في نظام Windows عندما يعجز سطر الأوامر (Command Prompt أو PowerShell) عن العثور على الملف التنفيذي لـ Node.js. يحدث هذا عادة بعد التثبيت مباشرة بسبب عدم إضافة مسار تثبيت Node.js إلى متغير البيئة PATH، أو لأن نافذة الـ Terminal المفتوحة لم تقم بتحديث بيانات البيئة بعد.

الطريقة 1: إعادة تشغيل موجه الأوامر (Terminal) أو الجهاز

إذا قمت بتثبيت Node.js أثناء فتح نافذة سطر الأوامر، فلن تتعرف الجلسة الحالية على المسارات الجديدة تلقائياً.

  • أغلق جميع نوافذ Command Prompt و PowerShell وأي بيئة تطوير مثل VS Code.
  • افتح نافذة جديدة وجرب كتابة: node -v
  • إذا استمرت المشكلة، قم بإعادة تشغيل الكمبيوتر لتحديث متغيرات النظام بالكامل.

الطريقة 2: التحقق من وجود مجلد تثبيت Node.js

تأكد من أن Node.js مثبت بالفعل على جهازك في المسار الافتراضي قبل تعديل المتغيرات يدوياً.

  • افتح مستكشف الملفات (File Explorer).
  • توجه إلى المسار الافتراضي: C:\Program Files\nodejs\ (أو C:\Program Files (x86)\nodejs\ للأنظمة ذات 32-bit).
  • تأكد من وجود الملفين node.exe و npm.cmd داخل المجلد.
  • إذا لم تجد المجلد، فقم بتحميل أداة التثبيت وتثبيتها من الموقع الرسمي nodejs.org.

الطريقة 3: إضافة مسار Node.js يدوياً إلى متغيرات البيئة (PATH)

إذا كان البرنامج مثبتاً داخل جهازك ولكن النظام لا يتعرف عليه، أضف المسار إلى إعدادات النظام يدوياً.

خطوات التعديل خطوة بخطوة:

  1. اضغط على مفتاحي Win + R واكتب sysdm.cpl ثم اضغط Enter لفتح خصائص النظام.
  2. انتقل إلى علامة التبويب Advanced، ثم اضغط على زر Environment Variables... في الأسفل.
  3. في قسم System variables (القسم السفلي)، ابحث عن متغير باسم Path وحدده.
  4. اضغط على زر Edit... لعرض المسارات المسجلة.
  5. اضغط على زر New في الجانب الأيمن والصق مسار مجلد Node.js:
    C:\Program Files\nodejs\
  6. اضغط على OK في جميع النوافذ الثلاث لحفظ التعديلات.

الطريقة 4: التحقق من نجاح الحل

لتأكيد إمكانية تشغيل Node.js ومدير الحزم NPM من أي مكان، افتح نافذة جديدة لموجه الأوامر ونفّذ الأوامر التالية:

  • node -v — سيعرض إصدار Node.js الحالي (مثال: v20.11.0).
  • npm -v — سيعرض إصدار أداة إدارة الحزم NPM.