تثبيت بايثون وتشغيل برنامجك الأول

المشكلة التي نقوم بحلها

تريد أن تتعلم بايثون. هناك العديد من المواقع التي تتيح لك كتابة الأكواد داخل المتصفح — لكن في بيئة العمل الحقيقية، لا أحد يكتب الأكواد داخل متصفح الإنترنت. في الشركات، يتم تثبيت بايثون على جهازك، وتفتح سطر الأوامر (Terminal)، وتنفذ الأوامر، وتحفظ الملفات وتشغلها.

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

بنهاية هذه المهمة ستكون قادراً على

• تثبيت بايثون 3.12 على نظام ويندوز
• التحقق عبر الطرفية (Terminal) من اكتمال التثبيت بنجاح
• كتابة ملف بصيغة .py وتشغيله
• التعرف على أكثر أخطاء التثبيت شيوعاً وحلها

المتطلبات المسبقة: لا يوجد. هذه هي المهمة الأولى.

الخطوة 1 — تنزيل بايثون

توجه إلى python.org/downloads واستخدم الزر لتنزيل أحدث إصدار من بايثون 3.12.

تجنب التثبيت من Microsoft Store. في نظام ويندوز، قد يؤدي كتابة أمر python إلى فتح المتجر تلقائياً. نسخة المتجر تعمل في بيئة مقيدة مما يسبب أخطاء لاحقة عند تثبيت الحزم. استخدم دائماً الرابط الرسمي من python.org.

الخطوة 2 — تفعيل خيار أساسي أثناء التثبيت

عند فتح برنامج التثبيت، ستجد خياراً في أسفل الشاشة الأولى:

[ ] Add python.exe to PATH

قم بتفعيله (Tick it). هذه أهم خطوة في المهمة بأكملها.

متغير PATH هو القائمة التي يعتمد عليها نظام ويندوز لتشغيل البرامج من أي مسار. بدون تفعيل هذا الخيار، سيتم تثبيت بايثون ولكن كتابة python في الطرفية ستعطيك رسالة خطأ لأن النظام لا يعرف أين تم تثبيته.

بعد ذلك اضغط على Install Now.

الخطوة 3 — التحقق من التثبيت

بعد انتهاء المعالج، افتح طرفية جديدة. اضغط على قائمة Start واكتب powershell ثم افتحها.

فتح طرفية جديدة أمر ضروري جداً، لأن أي نافذة كانت مفتوحة مسبقاً تحتفظ بإعدادات PATH القديمة ولن تتعرف على البرنامج المثبت حديثاً.

اكتب الأمر التالي:

python --version

يجب أن يظهر لك سطر مشابه لـ:

Python 3.12.7

اختلاف الرقم الأخير لا يهم — المهم أن تظهر النسخة 3.12.

الخطوة 4 — برنامجك الأول

أنشئ مجلداً على جهازك، وليكن D:\python-lab. أنشئ بداخله ملفاً باسم hello.py يحتوي على الكود التالي:

language = "Python"
print("Hello from", language)
print("2 + 3 =", 2 + 3)

انتقل الآن إلى المجلد عبر الطرفية وشغّل الملف:

cd D:\python-lab
python hello.py

المخرجات (Output):

Hello from Python
2 + 3 = 5

لقد قام جهازك الآن بتشغيل كود بايثون حقيقي لأول مرة. ليس عبر المتصفح — بل على نظامك المحلي.

عند حدوث مشاكل شائعة

كتابة python تفتح متجر Microsoft Store المسار غير مضاف إلى PATH. أعد تشغيل برنامج التثبيت، اختر Modify، وتأكد من تفعيل "Add python.exe to PATH".

ظهور خطأ The term 'python' is not recognized السبب نفسه والحل نفسه. يمكنك أيضاً تجربة أمر py --version، حيث يعمل مشغل py في ويندوز حتى لو لم يُضبط PATH.

ظهور خطأ can't open file عند تشغيل python hello.py أنت لست في المسار الصحيح. اكتب dir وتأكد من وجود الملف في القائمة، أو انتقل إلى المجلد باستخدام أمر cd.

الملف تم حفظه باسم hello.py.txt يقوم ويندوز بإخفاء امتدادات الملفات افتراضياً. من File Explorer فعّل View → Show → File name extensions ثم أزل .txt من اسم الملف.

دورك الآن

قم بتعديل ملف hello.py ليطبع اسمك الشخصي ويُظهر ناتج 7 * 6. احفظ الملف وشغّله مجدداً باستخدام python hello.py.

يجب أن تظهر المخرجات بشكل مشابه لما يلي:

Hello from <your name>
7 * 6 = 42