كيف تثبت JavaScript على ويندوز وماك — دليل خطوة بخطوة 2026

قبل أن تكتب سطر كود واحد، يجب أن تجهّز بيئة العمل على جهازك. قد تبدو الخطوة بسيطة، لكنها مصدر إاحباط لكثير من المبتدئين بسبب مشاكل التثبيت والإعدادات. في هذا الدليل العملي، سنأخذك خطوة بخطوة لتثبيت JavaScript بشكل صحيح على **ويندوز** و**ماك** — مع حل المشاكل الشائعة. ## لماذا JavaScript تحديداً؟ قبل أن نبدأ، دعنا نتفق على الأسباب: - **لغة الويب الأولى** — لا يمكنك بناء موقع تفاعلي بدونها - **الأكثر طلباً** — في تطوير الويب والواجهات الأمامية - **متعددة الاستخدامات** — من المتصفح إلى الخوادم (Node.js) - **مجتمع ضخم** — مصادر لا تنتهي للمساعدة ## ما ستحتاجه <table> <thead> <tr> <th>المتطلب</th> <th>التفاصيل</th> </tr> </thead> <tbody> <tr> <td><strong>جهاز كمبيوتر</strong></td> <td>ويندوز 10/11 أو ماك</td> </tr> <tr> <td><strong>اتصال إنترنت</strong></td> <td>لتحميل ملفات التثبيت</td> </tr> <tr> <td><strong>مساحة فارغة</strong></td> <td>~300 ميجابايت</td> </tr> <tr> <td><strong>وقت</strong></td> <td>15-20 دقيقة</td> </tr> </tbody> </table> ## الجزء الأول: التثبيت على ويندوز ### الخطوة 1: تحميل Node.js JavaScript لا تحتاج إلى "تثبيت" تقليدي، لكنك تحتاج إلى **Node.js** لتشغيلها خارج المتصفح. 1. اذهب إلى الموقع الرسمي: **nodejs.org** 2. اضغط على زر **Downloads** 3. اختر نسخة **LTS** (Long Term Support) — وهي الأكثر استقراراً 4. **⚠️ مهم:** اختر النسخة المناسبة لنظامك (Windows Installer 64-bit) 5. اضغط على زر التحميل **مثال للنسخة المناسبة:** node-v20.x.x-x64.msi ### الخطوة 2: تشغيل ملف التثبيت 1. افتح الملف الذي حمّلته (مثل `node-v20.x.x-x64.msi`) 2. اتبع الخطوات: - اضغط **Next** - وافق على الشروط **I accept the terms** - اختر مسار التثبيت الافتراضي - **⚠️ خطوة حاسمة:** تأكد من أن الخيار **Add to PATH** مُفعّل 3. اضغط **Install** 4. انتظر 1-2 دقيقة حتى ينتهي التثبيت 5. اضغط **Finish** ### الخطوة 3: التأكد من التثبيت 1. افتح **Command Prompt** أو **PowerShell**: - اضغط `Windows + R` - اكتب `cmd` - اضغط Enter 2. اكتب الأمر التالي: ```bash node --version ``` 3. **النتيجة المتوقعة:** ``` v20.x.x ``` ثم اكتب: ```bash npm --version ``` 4. **النتيجة المتوقعة:** 10.x.x **إذا ظهرت رسالة `'node' is not recognized`** — انتقل إلى قسم "حل المشاكل" أدناه. ### الخطوة 4: تثبيت VS Code (محرر الأكواد) 1. اذهب إلى: **://visualstudio.com** 2. حمّل النسخة المناسبة (Windows) 3. ثبّتها بالإعدادات الافتراضية 4. بعد التثبيت، افتح VS Code 5. اذهب إلى Extensions (Ctrl+Shift+X) 6. ابحث عن **JavaScript (ES6) code snippets** 7. اضغط Install ## الجزء الثاني: التثبيت على ماك ### الخطوة 1: تحميل Node.js 1. اذهب إلى: **nodejs.org** 2. اضغط **Downloads** 3. اختر نسخة LTS لنظام macOS (macOS Installer) 4. اضغط التحميل ### الخطوة 2: تشغيل ملف التثبيت 1. افتح ملف `.pkg` الذي حمّلته 2. اتبع الخطوات: - اضغط **Continue** - وافق على الشروط **Agree** - اضغط **Install** 3. أدخل كلمة مرور جهازك إذا طُلبت 4. انتظر 1-2 دقيقة 5. اضغط **Close** ### الخطوة 3: التأكد من التثبيت 1. افتح **Terminal**: - اضغط `Command + Space` - اكتب `Terminal` - اضغط Enter 2. اكتب: ```bash node --version ``` 3. **النتيجة المتوقعة:** v20.x.x ثم اكتب: ```bash npm --version ``` 4. **النتيجة المتوقعة:** 10.x.x ### الخطوة 4: تثبيت VS Code 1. اذهب إلى: **://visualstudio.com** 2. حمّل النسخة لـ macOS 3. افتح ملف `.zip` واسحب VS Code إلى مجلد Applications 4. افتح VS Code 5. اذهب إلى Extensions وثبّت **JavaScript (ES6) code snippets** ## الجزء الثالث: أول اختبار ### اكتب أول برنامج لك 1. افتح VS Code 2. أنشئ ملفاً جديداً باسم `hello.js` 3. اكتب فيه: ```javascript console.log("مرحباً بالعالم!"); console.log("بدأت رحلتي في JavaScript 🚀"); ``` 4. احفظ الملف (`Ctrl + S` أو `Cmd + S`) 5. لتشغيله عبر Terminal: ```bash node hello.js ``` 6. **النتيجة:** مرحباً بالعالم! بدأت رحلتي في JavaScript 🚀 **🎉 مبروك! أنت الآن مبرمج رسمياً!** ## حل المشاكل الشائعة ### 🔴 المشكلة 1: `'node' is not recognized` **السبب:** لم يتم إضافة Node.js إلى PATH أثناء التثبيت. **الحل:** **الطريقة 1 (الأسرع) — أعد التثبيت:** 1. اذهب إلى Control Panel → Programs 2. ابحث عن Node.js واحذفه 3. أعد التثبيت مع التأكد من تفعيل **Add to PATH** **الطريقة 2 — إضافة PATH يدوياً:** 1. اضغط `Windows + R` واكتب `sysdm.cpl` 2. اذهب إلى Advanced → Environment Variables 3. في User Variables، ابحث عن `Path` واضغط Edit 4. اضغط **New** وأضف: C:\Program Files\nodejs\ 5. اضغط OK وأعد فتح Command Prompt ### 🔴 المشكلة 2: `npm` لا يعمل **الحل:** جرب أحد هذه الأوامر: ```bash npm --version ``` أو: ```bash npx --version ``` إذا عمل أحدهما، استخدم نفس البادئة في المستقبل. ### 🔴 المشكلة 3: VS Code لا يتعرف على JavaScript **الحل:** 1. في VS Code، تأكد من أن امتداد الملف هو `.js` 2. اضغط `Ctrl + Shift + P` 3. اكتب: `Change Language Mode` 4. اختر **JavaScript** ### 🔴 المشكلة 4: تحميل Node.js بطيء جداً **الحل:** - استخدم VPN أو اتصالاً أسرع - حاول مرة أخرى في وقت مختلف - استخدم المرايا (Mirrors) من الموقع الرسمي ### 🔴 المشكلة 5: تعارض الإصدارات **الحل:** استخدم nvm (Node Version Manager) لإدارة إصدارات متعددة: - **ويندوز:** ://github.com - **ماك:** `brew install nvm` ## إعداد بيئة العمل الاحترافية ### 1. تثبيت المكتبات الأساسية افتح Terminal واكتب لطلب تشغيل خادم محلي لتطوير الويب: ```bash npm install -g live-server ``` هذه الأداة تسمح لك بتشغيل صفحات HTML مع JavaScript مباشرة. ### 2. إنشاء مشروع جديد هذه أفضل ممارسة لبدء إدارة حزم مشروعك: ```bash mkdir my-javascript-project cd my-javascript-project npm init -y ``` ### 3. تثبيت مكتبة للتطوير لحفظ جودة الكود وتجنب الأخطاء الإملائية: ```bash npm install --save-dev eslint npx eslint --init ``` ## جدول الأوامر الأساسية <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>إنشاء مشروع جديد</td> </tr> <tr> <td><code>npm install [package]</code></td> <td>تثبيت مكتبة</td> </tr> <tr> <td><code>npm list</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>تثبيت VS Code</td> <td>⬜</td> </tr> <tr> <td>تثبيت إضافة JavaScript في VS Code</td> <td>⬜</td> </tr> <tr> <td>كتابة وتشغيل أول برنامج</td> <td>⬜</td> </tr> <tr> <td>تثبيت live-server</td> <td>⬜</td> </tr> </tbody> </table> ## ماذا بعد التثبيت؟ الآن بعد أن أصبحت بيئة العمل جاهزة، حان وقت التعلم: 1. **تعلم الأساسيات:** المتغيرات، الشروط، الحلقات 2. **تعلم DOM:** التعامل مع عناصر الصفحة وتغيير محتواها 3. **اكتب مشاريع صغيرة:** آلة حاسبة، قائمة مهام 4. **تعلم Git:** لحفظ كودك على GitHub 5. **انضم لمجتمع:** Reddit، Discord، Stack Overflow ## الخلاصة تثبيت JavaScript (عبر Node.js) عملية بسيطة إذا اتبعت الخطوات الصحيحة. أهم النقاط: - ✅ **ويندوز:** تأكد من تفعيل "Add to PATH" أثناء التثبيت - ✅ **ماك:** استخدم Terminal للتحقق من التثبيت - ✅ **VS Code:** محرر ممتاز مع دعم كامل لـ JavaScript - ✅ **Node.js:** ضروري لتشغيل JavaScript خارج المتصفح **تذكر:** إذا واجهت مشكلة، ابحث عنها بالإنجليزية على Google — 99% من المشاكل لها حل جاهز. **هل نجح تثبيت JavaScript؟ شاركنا في التعليقات!** --- ### ✅ بعد النسخ: 1. احفظ الملف في `content/articles/install-javascript-guide.md`. 2. أخبرني **"تم"** لأكمل معك الخطوة التالية.