Node.js
كيف تثبت Node.js — دليل إعداد البيئة 2026
📅 2026-11-01⏱ 6 دقائق قراءة
بعد أن أتقنت 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.
- **مجتمع ضخم:** مصادر لا تنتهي.
## ما ستحتاجه
<table>
<thead>
<tr>
<th>المتطلب</th>
<th>التفاصيل</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>جهاز كمبيوتر</strong></td>
<td>ويندوز 10/11 أو ماك</td>
</tr>
<tr>
<td><strong>VS Code</strong></td>
<td>محرر الأكواد (مجاني)</td>
</tr>
<tr>
<td><strong>معرفة بـ JavaScript</strong></td>
<td>من مسار JavaScript</td>
</tr>
<tr>
<td><strong>وقت</strong></td>
<td>15-20 دقيقة</td>
</tr>
</tbody>
</table>
**⚠️ مهم:** إذا لم تكن قد أتممت مسار 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** (ماك)، واكتب:
```bash
node --version
```
**النتيجة المتوقعة:**
```
v20.x.x
```
ثم اكتب:
```bash
npm --version
```
**النتيجة المتوقعة:**
```
10.x.x
```
**🎉 مبروك! Node.js و npm مثبتان!**
## الجزء الثاني: فهم npm
**npm** = **Node Package Manager** (مدير حزم Node.js).
**وظائفه:**
- تثبيت المكتبات.
- إدارة التبعيات.
- تشغيل السكربتات.
- نشر الحزم.
### أوامر npm الأساسية:
```bash
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`
هو **بطاقة تعريف المشروع**:
```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: إنشاء المجلد
```bash
mkdir my-first-node
cd my-first-node
```
### الخطوة 2: إنشاء `package.json`
```bash
npm init -y
```
### الخطوة 3: إنشاء ملف `index.js`
**افتح VS Code** في المجلد، وأنشئ ملف `index.js`:
```javascript
console.log("مرحباً من Node.js! 🎉");
console.log("أول برنامج لي على السيرفر!");
```
**احفظ الملف.**
### الخطوة 4: تشغيل البرنامج
في Terminal:
```bash
node index.js
```
**النتيجة المتوقعة:**
```
مرحباً من Node.js! 🎉
أول برنامج لي على السيرفر!
```
**🎉 مبروك! شغّلت أول برنامج Node.js!**
## الجزء الرابع: تثبيت VS Code والإضافات
### 1. تثبيت VS Code
إذا لم يكن مثبتاً:
1. اذهب إلى: **code.visualstudio.com**
2. حمّل النسخة المناسبة
3. ثبّتها
### 2. الإضافات المهمة لـ Node.js
<table>
<thead>
<tr>
<th>الإضافة</th>
<th>الوظيفة</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>ESLint</strong></td>
<td>تحليل الكود</td>
</tr>
<tr>
<td><strong>Prettier</strong></td>
<td>تنسيق الكود</td>
</tr>
<tr>
<td><strong>Node.js Extension Pack</strong></td>
<td>مجموعة إضافات Node.js</td>
</tr>
<tr>
<td><strong>npm Intellisense</strong></td>
<td>إكمال تلقائي للمكتبات</td>
</tr>
<tr>
<td><strong>Path Intellisense</strong></td>
<td>إكمال المسارات</td>
</tr>
<tr>
<td><strong>REST Client</strong></td>
<td>اختبار APIs من VS Code</td>
</tr>
</tbody>
</table>
## الجزء الخامس: تثبيت nodemon
**nodemon** هو أداة **تعيد تشغيل السيرفر تلقائياً** عند تعديل الملفات.
### التثبيت:
```bash
npm install -D nodemon
```
### الاستخدام:
بدلاً من:
```bash
node index.js
```
استخدم:
```bash
npx nodemon index.js
```
**النتيجة:** أي تعديل في `index.js` سيعيد تشغيل السيرفر تلقائياً.
### إضافته إلى `package.json`:
```json
"scripts": {
"start": "node index.js",
"dev": "nodemon index.js"
}
```
ثم:
```bash
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` بطيء
**الحل:** استخدم مرآة أسرع:
```bash
npm config set registry https://registry.npmmirror.com
```
### 🔴 المشكلة 3: `EACCES: permission denied`
**السبب:** مشكلة صلاحيات.
**الحل (ماك/لينكس):**
```bash
sudo chown -R $(whoami) ~/.npm
```
### 🔴 المشكلة 4: تعارض الإصدارات
**الحل:** استخدم **nvm** (Node Version Manager):
- ويندوز: **github.com/coreybutler/nvm-windows**
- ماك: `brew install nvm`
### 🔴 المشكلة 5: `Cannot find module 'xxx'`
**الحل:** ثبّت المكتبة:
```bash
npm install xxx
```
## جدول الأوامر الأساسية
<table>
<thead>
<tr>
<th>الأمر</th>
<th>الوظيفة</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>node --version</code></td>
<td>عرض إصدار Node.js</td>
</tr>
<tr>
<td><code>npm --version</code></td>
<td>عرض إصدار npm</td>
</tr>
<tr>
<td><code>node file.js</code></td>
<td>تشغيل ملف JavaScript</td>
</tr>
<tr>
<td><code>npm init -y</code></td>
<td>إنشاء package.json</td>
</tr>
<tr>
<td><code>npm install <package></code></td>
<td>تثبيت مكتبة</td>
</tr>
<tr>
<td><code>npm install -D <package></code></td>
<td>تثبيت للتطوير</td>
</tr>
<tr>
<td><code>npx nodemon file.js</code></td>
<td>تشغيل مع إعادة تلقائية</td>
</tr>
</tbody>
</table>
## قائمة تحقق نهائية
<table>
<thead>
<tr>
<th>المهمة</th>
<th>الحالة</th>
</tr>
</thead>
<tbody>
<tr>
<td>تثبيت Node.js (LTS)</td>
<td>⬜</td>
</tr>
<tr>
<td>تأكيد عمل <code>node --version</code></td>
<td>⬜</td>
</tr>
<tr>
<td>تأكيد عمل <code>npm --version</code></td>
<td>⬜</td>
</tr>
<tr>
<td>تثبيت VS Code</td>
<td>⬜</td>
</tr>
<tr>
<td>إنشاء مشروع Node.js</td>
<td>⬜</td>
</tr>
<tr>
<td>كتابة وتشغيل أول برنامج</td>
<td>⬜</td>
</tr>
<tr>
<td>تثبيت nodemon</td>
<td>⬜</td>
</tr>
</tbody>
</table>
## ماذا بعد هذا المقال؟
الآن بعد أن أصبحت بيئة العمل جاهزة، حان وقت التعلم:
1. **أول برنامج Node.js** — تعمق في الأساسيات.
2. **الوحدات (Modules)** — تنظيم الكود.
3. **نظام الملفات (fs)** — التعامل مع الملفات.
## الخلاصة
تثبيت Node.js عملية بسيطة. أهم النقاط:
- ✅ **Node.js LTS:** الأكثر استقراراً.
- ✅ **npm:** مدير الحزم.
- ✅ **package.json:** بطاقة تعريف المشروع.
- ✅ **nodemon:** إعادة تشغيل تلقائية.
- ✅ **VS Code:** محرر احترافي مع دعم Node.js.
**تذكر:** إذا واجهت مشكلة، ابحث عنها بالإنجليزية على Google.