كيف تثبت Node.js — دليل إعداد البيئة 2026

بعد أن أتقنت JavaScript و TypeScript، حان الوقت للانتقال إلى Node.js — لبيئة تشغيل JavaScript على السيرفر (Backend).

في هذا الدليل العملي، سنأخذك خطوة بخطوة لتثبيت Node.js وإعداد بيئة العمل، مع حل المشاكل الشائعة.

ما هو Node.js؟

Node.js هو بيئة تشغيل (Runtime Environment) تسمح بتشغيل JavaScript خارج المتصفح (على السيرفر).

تشبيه بسيط:

• JavaScript في المتصفح: يُشغّل تفاعل الصفحة (أزرار، نماذج).
• JavaScript في Node.js: يُشغّل السيرفر، APIs، قواعد البيانات.

قبل Node.js:

• JavaScript كانت تعمل فقط في المتصفح.
• السيرفر يستخدم PHP، Python، Ruby، Java.

مع Node.js:

• ✅ نفس اللغة (JavaScript) للـ Frontend و Backend.
• ✅ أداء عالٍ (V8 Engine).
• ✅ مجتمع ضخم.
• ✅ npm (أكبر مستودع حزم في العالم).

لماذا Node.js؟

قبل أن نبدأ، دعنا نتفق على الأسباب:

• لغة واحدة: JavaScript في كل مكان.
• سريع: يعتمد على V8 Engine (محرك Chrome).
• غير متزامن: يتعامل مع آلاف الطلبات بكفاءة.
• npm: أكبر مستودع حزم في العالم (2+ مليون حزمة).
• مطلوب في سوق العمل: Netflix، PayPal، Uber، LinkedIn.
• مجتمع ضخم: مصادر لا تنتهي.

ما ستحتاجه

المتطلب	التفاصيل
جهاز كمبيوتر	ويندوز 10/11 أو ماك
VS Code	محرر الأكواد (مجاني)
معرفة بـ JavaScript	من مسار JavaScript
وقت	15-20 دقيقة

⚠️ مهم: إذا لم تكن قد أتممت مسار JavaScript، راجعه أولاً.

الجزء الأول: تثبيت Node.js

الخطوة 1: تحميل Node.js

1. اذهب إلى الموقع الرسمي: nodejs.org
2. اضغط على زر Downloads
3. اختر نسخة LTS (Long Term Support) — وهي الأكثر استقراراً
4. ⚠️ مهم: اختر النسخة المناسبة لنظامك
5. اضغط على زر التحميل

مثال للنسخة المناسبة:

node-v20.x.x-x64.msi     (ويندوز)
node-v20.x.x.pkg         (ماك)

الخطوة 2: تشغيل ملف التثبيت

على ويندوز:

1. افتح الملف الذي حمّلته (مثل node-v20.x.x-x64.msi)
2. اتبع الخطوات:
   • اضغط Next
   • وافق على الشروط I accept the terms
   • اختر مسار التثبيت الافتراضي
   • ⚠️ خطوة حاسمة: تأكد من أن الخيار Add to PATH مُفعّل
3. اضغط Install
4. انتظر 1-2 دقيقة
5. اضغط Finish

على ماك:

1. افتح ملف .pkg الذي حمّلته
2. اتبع الخطوات:
   • اضغط Continue
   • وافق على الشروط Agree
   • اضغط Install
3. أدخل كلمة مرور جهازك إذا طُلبت
4. انتظر 1-2 دقيقة
5. اضغط Close

الخطوة 3: التأكد من التثبيت

افتح Command Prompt (ويندوز) أو Terminal (ماك)، واكتب:

node --version

النتيجة المتوقعة:

v20.x.x

ثم اكتب:

npm --version

النتيجة المتوقعة:

10.x.x

🎉 مبروك! Node.js و npm مثبتان!

الجزء الثاني: فهم npm

npm = Node Package Manager (مدير حزم Node.js).

وظائفه:

• تثبيت المكتبات.
• إدارة التبعيات.
• تشغيل السكربتات.
• نشر الحزم.

أوامر npm الأساسية:

npm --version          # عرض الإصدار
npm init               # إنشاء package.json
npm init -y            # إنشاء سريع
npm install <package>  # تثبيت مكتبة
npm install -D <package> # تثبيت للتطوير
npm uninstall <package> # إزالة مكتبة
npm update             # تحديث المكتبات
npm list               # عرض المكتبات المثبتة
npm run <script>       # تشغيل سكربت

ملف package.json

هو بطاقة تعريف المشروع:

{
  "name": "my-node-app",
  "version": "1.0.0",
  "description": "أول تطبيق Node.js",
  "main": "index.js",
  "scripts": {
    "start": "node index.js",
    "dev": "nodemon index.js"
  },
  "keywords": ["nodejs", "javascript"],
  "author": "أحمد",
  "license": "MIT",
  "dependencies": {
    "express": "^4.18.2"
  },
  "devDependencies": {
    "nodemon": "^3.0.1"
  }
}

الجزء الثالث: إنشاء أول مشروع

الخطوة 1: إنشاء المجلد

mkdir my-first-node
cd my-first-node

الخطوة 2: إنشاء package.json

npm init -y

الخطوة 3: إنشاء ملف index.js

افتح VS Code في المجلد، وأنشئ ملف index.js:

console.log("مرحباً من Node.js! 🎉");
console.log("أول برنامج لي على السيرفر!");

احفظ الملف.

الخطوة 4: تشغيل البرنامج

في Terminal:

node index.js

النتيجة المتوقعة:

مرحباً من Node.js! 🎉
أول برنامج لي على السيرفر!

🎉 مبروك! شغّلت أول برنامج Node.js!

الجزء الرابع: تثبيت VS Code والإضافات

1. تثبيت VS Code

إذا لم يكن مثبتاً:

1. اذهب إلى: code.visualstudio.com
2. حمّل النسخة المناسبة
3. ثبّتها

2. الإضافات المهمة لـ Node.js

الإضافة	الوظيفة
ESLint	تحليل الكود
Prettier	تنسيق الكود
Node.js Extension Pack	مجموعة إضافات Node.js
npm Intellisense	إكمال تلقائي للمكتبات
Path Intellisense	إكمال المسارات
REST Client	اختبار APIs من VS Code

الجزء الخامس: تثبيت nodemon

nodemon هو أداة تعيد تشغيل السيرفر تلقائياً عند تعديل الملفات.

التثبيت:

npm install -D nodemon

الاستخدام:

بدلاً من:

node index.js

استخدم:

npx nodemon index.js

النتيجة: أي تعديل في index.js سيعيد تشغيل السيرفر تلقائياً.

إضافته إلى package.json:

"scripts": {
  "start": "node index.js",
  "dev": "nodemon index.js"
}

ثم:

npm run dev

الجزء السادس: بنية المشروع

بعد إتمام كل شيء:

my-first-node/
├── node_modules/        # المكتبات المثبتة
├── index.js             # نقطة البداية
├── package.json         # إعدادات المشروع
├── package-lock.json    # قفل الإصدارات
└── .gitignore           # الملفات المستبعدة

ملف .gitignore

أنشئ ملف .gitignore لمنع رفع node_modules:

node_modules/
.env
*.log
.DS_Store

حل المشاكل الشائعة

🔴 المشكلة 1: 'node' is not recognized

السبب: Node.js غير مضاف إلى PATH.

الحل:

1. أعد تثبيت Node.js.
2. تأكد من تفعيل Add to PATH.
3. أعد تشغيل Terminal.

🔴 المشكلة 2: npm install بطيء

الحل: استخدم مرآة أسرع:

npm config set registry https://registry.npmmirror.com

🔴 المشكلة 3: EACCES: permission denied

السبب: مشكلة صلاحيات.

الحل (ماك/لينكس):

sudo chown -R $(whoami) ~/.npm

🔴 المشكلة 4: تعارض الإصدارات

الحل: استخدم nvm (Node Version Manager):

• ويندوز: github.com/coreybutler/nvm-windows
• ماك: brew install nvm

🔴 المشكلة 5: Cannot find module 'xxx'

الحل: ثبّت المكتبة:

npm install xxx

جدول الأوامر الأساسية

الأمر	الوظيفة
node --version	عرض إصدار Node.js
npm --version	عرض إصدار npm
node file.js	تشغيل ملف JavaScript
npm init -y	إنشاء package.json
npm install <package>	تثبيت مكتبة
npm install -D <package>	تثبيت للتطوير
npx nodemon file.js	تشغيل مع إعادة تلقائية

قائمة تحقق نهائية

المهمة	الحالة
تثبيت Node.js (LTS)	⬜
تأكيد عمل node --version	⬜
تأكيد عمل npm --version	⬜
تثبيت VS Code	⬜
إنشاء مشروع Node.js	⬜
كتابة وتشغيل أول برنامج	⬜
تثبيت nodemon	⬜

ماذا بعد هذا المقال؟

الآن بعد أن أصبحت بيئة العمل جاهزة، حان وقت التعلم:

1. أول برنامج Node.js — تعمق في الأساسيات.
2. الوحدات (Modules) — تنظيم الكود.
3. نظام الملفات (fs) — التعامل مع الملفات.

الخلاصة

تثبيت Node.js عملية بسيطة. أهم النقاط:

• ✅ Node.js LTS: الأكثر استقراراً.
• ✅ npm: مدير الحزم.
• ✅ package.json: بطاقة تعريف المشروع.
• ✅ nodemon: إعادة تشغيل تلقائية.
• ✅ VS Code: محرر احترافي مع دعم Node.js.

تذكر: إذا واجهت مشكلة، ابحث عنها بالإنجليزية على Google.