ما هو Node.js بالضبط؟
بيئة تشغيل JavaScript خارج المتصفح مبنية على محرك V8، تتيح كتابة خوادم وأدوات سطر أوامر بنفس اللغة المستخدمة في الواجهة. معها npm، أحد أكبر سجلات الحزم في البرمجة.
- خوادم وواجهات برمجية تتعامل مع طلبات كثيرة متزامنة
- أدوات بناء المشاريع الأمامية
- استخدام نفس اللغة في الواجهة والخادم
- غير مناسب للعمليات الحسابية الطويلة لأنه أحادي الخيط في الأساس
- شجرة الاعتماديات تكبر بسرعة، وكل حزمة إضافية مساحة خطر أمني جديدة
- اختلاف السلوك بين الإصدارات الكبرى قد يكسر مشروعاً قديماً
مشكلات شائعة في Node.js وحلولها
المشروع يعمل على جهاز ولا يعمل على آخر
لماذا يحدث: اختلاف إصدار Node بين الجهازين، أو تثبيت الحزم دون احترام ملف القفل.
الحل: ثبّت إصدار Node في ملف .nvmrc واستخدم مدير إصدارات. وفي البناء استخدم npm ci التي تلتزم بملف package-lock.json بدل npm install.
أخطاء صلاحيات عند التثبيت العام
لماذا يحدث: التثبيت العام يكتب في مجلدات النظام، فيُطلب مستخدم أعلى صلاحية.
الحل: لا تستخدم sudo مع npm. استخدم مدير إصدارات يضع Node في مجلد المستخدم، أو npx لتشغيل أداة مرة واحدة دون تثبيت.
بدائل Node.js — ومتى يكون البديل أفضل
أبرز المزايا
- تشغيل JavaScript
- npm مدمج
- نظام مكتبات واسع
متطلبات التشغيل
- نظام مدعوم
- طرفية
- مساحة لحزم npm
خطوات تنزيل وتثبيت Node.js
اختر إصدار LTS
طريقة التنفيذ: نفّذ هذه الخطوة بهدوء وتحقق من ظهور النتيجة قبل الانتقال للخطوة التالية. استخدم الموقع الرسمي واختر النسخة المطابقة لنظام جهازك.
لماذا هذه الخطوة؟ لأنها تعزل جزءاً من المشكلة وتقلل احتمال تكرار العمل أو تغيير إعداد غير ضروري في Node.js.
نزّل المثبت الرسمي
طريقة التنفيذ: نفّذ هذه الخطوة بهدوء وتحقق من ظهور النتيجة قبل الانتقال للخطوة التالية. استخدم الموقع الرسمي واختر النسخة المطابقة لنظام جهازك.
لماذا هذه الخطوة؟ لأنها تعزل جزءاً من المشكلة وتقلل احتمال تكرار العمل أو تغيير إعداد غير ضروري في Node.js.
افتح تفاصيل هذه الخطوة ←تحقق باستخدام node -v
طريقة التنفيذ: نفّذ هذه الخطوة بهدوء وتحقق من ظهور النتيجة قبل الانتقال للخطوة التالية. استخدم الموقع الرسمي واختر النسخة المطابقة لنظام جهازك.
لماذا هذه الخطوة؟ لأنها تعزل جزءاً من المشكلة وتقلل احتمال تكرار العمل أو تغيير إعداد غير ضروري في Node.js.
افتح تفاصيل هذه الخطوة ←ابدأ مشروعًا داخل مجلد منفصل
طريقة التنفيذ: نفّذ هذه الخطوة بهدوء وتحقق من ظهور النتيجة قبل الانتقال للخطوة التالية. استخدم الموقع الرسمي واختر النسخة المطابقة لنظام جهازك.
لماذا هذه الخطوة؟ لأنها تعزل جزءاً من المشكلة وتقلل احتمال تكرار العمل أو تغيير إعداد غير ضروري في Node.js.
افتح تفاصيل هذه الخطوة ←شرح مرئي سريع
خريطة مختصرة تساعدك على رؤية المسار كاملًا قبل بدء التنفيذ.
استخدم زر «حفظ كـ PDF» ثم اختر Save as PDF من نافذة الطباعة.
راجع الواجهة أو التعليمات الحالية لدى المصدر قبل التنفيذ.
الرسوم هنا توضيحية من ليكاندو وليست لقطة شاشة للواجهة الرسمية. الواجهات قد تتغير؛ المرجع المرتبط هو الفيصل.
تثبيت Node.js خطوة بخطوة لكل نظام
اختر تبويب نظامك فقط. أسماء الأزرار قد تختلف قليلاً مع تحديث الناشر، لذلك طابق اسم التطبيق والنطاق قبل المتابعة.
Windowsفتح الشرح
التنزيل والتثبيت
- 1تحقق من أن الناشر واسم الملف يطابقان الصفحة الرسمية.
- 2افتح ملف التثبيت مرة واحدة ووافق على نافذة النظام فقط إذا ظهر اسم الناشر الصحيح.
- 3اختر مسار التثبيت الافتراضي ما لم تكن لديك سياسة عمل مختلفة.
أول تشغيل آمن
- افتح البرنامج من قائمة Start.
- راجع الأذونات وخيارات التشغيل التلقائي قبل الموافقة.
- ثبّت التحديث المتاح من داخل البرنامج أو من الناشر.
كيف تعرف أن العملية نجحت؟
- يظهر اسم البرنامج في Installed apps.
- يفتح دون تحذير ناشر مجهول.
- يعرض الإصدار من About أو Help.
افتح Settings ثم Apps ثم Installed apps، وابحث عن Node.js واختر Uninstall.
macOSفتح الشرح
التنزيل والتثبيت
- 1نزّل نسخة macOS المناسبة لمعالج الجهاز عندما يعرض الناشر أكثر من خيار.
- 2افتح DMG أو الحزمة الرسمية، ثم انقل التطبيق إلى Applications إذا طلب ذلك.
- 3امنح أقل قدر من صلاحيات Privacy & Security اللازمة للوظيفة.
أول تشغيل آمن
- افتح التطبيق من Applications.
- إذا منع Gatekeeper الفتح، تحقق من الناشر قبل استخدام Open Anyway.
- راجع عناصر Login Items ولا تفعل التشغيل التلقائي بلا حاجة.
كيف تعرف أن العملية نجحت؟
- يظهر التطبيق داخل Applications.
- يفتح من دون رسالة تلف أو ناشر غير معروف.
- يعرض رقم إصدار حديث في About.
أغلق Node.js ثم انقله من Applications إلى Trash، واتبع تعليمات الناشر إن كان يثبت مكونات إضافية.
Linuxفتح الشرح
التنزيل والتثبيت
- 1استخدم مستودع التوزيعة أو الحزمة التي يوصي بها الناشر.
- 2راجع اسم الحزمة والمعمارية قبل التثبيت.
- 3لا تنفذ أمراً من صفحة غير رسمية بصلاحية root.
أول تشغيل آمن
- شغّل التطبيق كمستخدم عادي.
- راجع سجل الطرفية إذا فشل التشغيل.
- ثبّت التحديثات من مدير الحزم نفسه.
كيف تعرف أن العملية نجحت؟
- مدير الحزم يعرض الحزمة مثبتة.
- الأمر الخاص بالإصدار يعمل إن كان متاحاً.
- لا توجد مكتبات ناقصة في رسالة التشغيل.
استخدم مدير الحزم الذي ثبتت منه Node.js، وراجع الحزم التي سيزيلها قبل التأكيد.
ابدأ من نظام التشغيل الظاهر في إعدادات جهازك، ثم اختر النسخة المستقرة الرسمية. لا تختَر ARM أو x64 أو إصداراً تجريبياً بالتخمين.
أدوات مناسبة لهذا الموضوع
نصائح الأمان والاستخدام
- استخدم LTS للإنتاج
- افحص npm audit
- لا تشغّل حزمًا مجهولة
أسئلة شائعة عن Node.js
هل رابط التنزيل آمن؟
الزر الرئيسي يفتح نطاق الناشر المذكور في الصفحة. طابق النطاق وHTTPS، ولا تستخدم نسخة إعادة رفع مجهولة.
هل يعمل على جهازي؟
الأنظمة المذكورة هي Windows / macOS / Linux. راجع المتطلبات الحالية لدى الناشر لأن التوافق قد يتغير مع الإصدار.
هل البرنامج مجاني؟
الترخيص المعروض: مجاني ومفتوح المصدر. قد توجد خطط أو إضافات مدفوعة؛ صفحة التسعير الرسمية هي المرجع النهائي.