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

قبل أن تكتب سطر كود واحد، يجب أن تجهّز بيئة العمل على جهازك. قد تبدو الخطوة بسيطة، لكنها مصدر إاحباط لكثير من المبتدئين بسبب مشاكل التثبيت والإعدادات.

في هذا الدليل العملي، سنأخذك خطوة بخطوة لتثبيت JavaScript بشكل صحيح على ويندوز وماك — مع حل المشاكل الشائعة.

لماذا JavaScript تحديداً؟

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

• لغة الويب الأولى — لا يمكنك بناء موقع تفاعلي بدونها
• الأكثر طلباً — في تطوير الويب والواجهات الأمامية
• متعددة الاستخدامات — من المتصفح إلى الخوادم (Node.js)
• مجتمع ضخم — مصادر لا تنتهي للمساعدة

ما ستحتاجه

المتطلب	التفاصيل
جهاز كمبيوتر	ويندوز 10/11 أو ماك
اتصال إنترنت	لتحميل ملفات التثبيت
مساحة فارغة	~300 ميجابايت
وقت	15-20 دقيقة

الجزء الأول: التثبيت على ويندوز

الخطوة 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. اكتب الأمر التالي:

node --version

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

v20.x.x

ثم اكتب:

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. اكتب:

node --version

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

v20.x.x

ثم اكتب:

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. اكتب فيه:

console.log("مرحباً بالعالم!");
console.log("بدأت رحلتي في JavaScript 🚀");

4. احفظ الملف (Ctrl + S أو Cmd + S)
5. لتشغيله عبر Terminal:

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 لا يعمل

الحل: جرب أحد هذه الأوامر:

npm --version

أو:

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 واكتب لطلب تشغيل خادم محلي لتطوير الويب:

npm install -g live-server

هذه الأداة تسمح لك بتشغيل صفحات HTML مع JavaScript مباشرة.

2. إنشاء مشروع جديد

هذه أفضل ممارسة لبدء إدارة حزم مشروعك:

mkdir my-javascript-project
cd my-javascript-project
npm init -y

3. تثبيت مكتبة للتطوير

لحفظ جودة الكود وتجنب الأخطاء الإملائية:

npm install --save-dev eslint
npx eslint --init

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

الأمر	الوظيفة
node --version	عرض إصدار Node.js
npm --version	عرض إصدار npm
node file.js	تشغيل ملف JavaScript
npm init -y	إنشاء مشروع جديد
npm install [package]	تثبيت مكتبة
npm list	عرض المكتبات المثبتة

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

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

ماذا بعد التثبيت؟

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

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. أخبرني "تم" لأكمل معك الخطوة التالية.