كيف تثبت 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. - **مجتمع ضخم:** مصادر لا تنتهي. ## ما ستحتاجه <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 &lt;package&gt;</code></td> <td>تثبيت مكتبة</td> </tr> <tr> <td><code>npm install -D &lt;package&gt;</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.