الدرس 06 من دورة Python للمبتدئين

لا تخف من الخطأ: أصلح أشهر مشاكل تشغيل أول برنامج

في الدرس السابق شغّلنا أول برنامج Python. في هذا الدرس سنتعامل مع أشهر الأخطاء التي قد تظهر للمبتدئ، ونتعلم كيف نقرأ الخطأ ونصلحه بهدوء.

المستوى: مبتدئ جدًا النتيجة: معرفة حل أشهر الأخطاء مدة التطبيق: 10 - 15 دقيقة
طريقة CIT للتعلم الهادئ: الخطأ في البرمجة ليس نهاية الطريق. الخطأ رسالة. اقرأها بهدوء، واسأل: هل المشكلة في الأمر؟ في اسم الملف؟ في الحفظ؟ أم في مكان Terminal؟
مهم قبل البداية: هذا الدرس يعتمد على أنك كتبت وشغلت البرنامج السابق. افتح مجلد python_course وملف lesson_04.py حتى تطبق الحلول مباشرة.

ما النتيجة التي يجب أن تخرج بها؟

بنهاية هذا الدرس يجب أن تعرف كيف تتعامل مع رسائل خطأ مثل: 

python is not recognized
can't open file
SyntaxError
NameError
ماذا سنتعلم؟ قراءة الخطأ بدل الخوف منه.
ماذا سنراجع؟ الحفظ، اسم الملف، مكان Terminal.
ماذا نريد؟ تشغيل البرنامج مرة أخرى بنجاح.
خريطة التعامل مع أخطاء Python الشائعة
أشهر أخطاء Python الشائعة وحلولها
1

الخطأ الأول: python is not recognized

قد تكتب في Terminal: 

python lesson_04.py

ثم تظهر رسالة معناها أن Windows لم يتعرف على أمر python.

المعنى ببساطة: Python قد يكون مثبتًا، لكن Windows لا يعرف كيف يصل إليه من خلال أمر python.

الحل السريع: جرّب الأمر التالي: 

py lesson_04.py
تحقق قبل الانتقال ✅ هل عمل البرنامج باستخدام الأمر py؟ إذا نعم، فأنت تستطيع المتابعة. لاحقًا يمكن مراجعة PATH إذا أردت استخدام python بدل py.
2

الخطأ الثاني: can't open file

هذه الرسالة تعني غالبًا أن Python لم يجد الملف الذي طلبت تشغيله.

راجع هذه الأشياء:

  • هل اسم الملف مكتوب هكذا بالضبط؟
lesson_04.py
  • هل Terminal مفتوح داخل مجلد python_course؟
  • هل الملف ظاهر في Explorer داخل VS Code؟
خطأ شائع: كتابة اسم الملف بشكل مختلف مثل lesson04.py أو lesson_4.py يجعل Python يبحث عن ملف غير موجود.
سؤال سريع 🧠 هل اسم الملف في Explorer مطابق تمامًا للاسم الذي كتبته في Terminal؟ إذا نعم، انتقل للخطأ التالي.
3

الخطأ الثالث: SyntaxError

هذا الخطأ يعني أن Python وجد مشكلة في طريقة كتابة السطر.

المثال الصحيح: 

print("Hello, CIT Blog")

أمثلة تسبب الخطأ: 

print("Hello, CIT Blog)
print("Hello, CIT Blog"
print "Hello, CIT Blog"
ماذا تراجع؟ تأكد أن الأقواس مكتملة، وأن النص بين علامتي تنصيص، وأنك لم تنس علامة إغلاق.
تحقق قبل الانتقال ✅ هل أصبح السطر مطابقًا للمثال الصحيح؟ إذا نعم، احفظ الملف وشغّله مرة أخرى.
4

الخطأ الرابع: NameError

يظهر هذا الخطأ عندما يقرأ Python كلمة لا يعرفها.

مثال خطأ: 

prnt("Hello, CIT Blog")

هنا كتبنا prnt بدل print، لذلك Python لا يعرف هذا الأمر.

الصواب: 

print("Hello, CIT Blog")
سؤال سريع 🧠 هل كتبت print بشكل صحيح؟ لا تنقص حرفًا ولا تضف حرفًا.
5

الخطأ الخامس: نسيت حفظ الملف

أحيانًا تعدّل السطر داخل Editor، ثم تشغل الملف، لكن النتيجة لا تتغير.

السبب غالبًا أنك لم تحفظ الملف بعد التعديل. 

Ctrl + S
القاعدة الذهبية: اكتب الكود، ثم احفظ، ثم شغّل. لا تشغّل قبل الحفظ.
تحقق قبل الانتقال ✅ هل حفظت الملف قبل التشغيل؟ إذا نعم، جرّب التشغيل مرة أخرى.

اختبار نهاية الدرس

قبل الانتقال للدرس القادم، تأكد أنك تعرف ماذا تفعل في الحالات التالية:

✅ إذا لم يعمل python، أجرب py.
✅ إذا ظهر can't open file، أراجع اسم الملف ومكان Terminal.
✅ إذا ظهر SyntaxError، أراجع الأقواس وعلامات التنصيص.
✅ إذا ظهر NameError، أراجع كتابة print.
✅ إذا لم تتغير النتيجة، أحفظ الملف باستخدام Ctrl + S.
✅ لا أخاف من الخطأ؛ أقرأه بهدوء.
إذا فهمت هذه النقاط: أنت لم تتعلم تشغيل البرنامج فقط، بل بدأت تتعلم كيف تفكر كمبرمج عند ظهور مشكلة.

خلاصة الدرس

الخطأ جزء طبيعي من البرمجة. المبتدئ لا يحتاج أن يعرف كل شيء، لكنه يحتاج أن يعرف كيف يتوقف، يقرأ الرسالة، ويراجع السبب المحتمل.

تذكر هذا التسلسل: 

اقرأ الخطأ
راجع الحفظ
راجع اسم الملف
راجع مكان Terminal
جرّب الحل
شغّل من جديد
الدرس السابق الدرس التالي: المتغيرات قريبًا فهرس الدورة