🐍 شرح Python

بناء الجملة والتعليقات

بناء الجملة في بايثون

أهم ما يميّز بايثون عن باقي اللغات أنها تعتمد على المسافات البادئة (Indentation) لتحديد الكتل البرمجية، بدلًا من الأقواس { }.

if 5 > 2:
    print("خمسة أكبر من اثنين")

المسافة قبل print ليست للتجميل — هي التي تخبر بايثون أن هذا السطر ينتمي لكتلة if. الاتفاق العالمي هو استخدام 4 مسافات لكل مستوى.

خطأ شائع: المسافات غير المتطابقة

if 5 > 2:
    print("سطر صحيح")
        print("سيسبب خطأ IndentationError")

⚠️ لا تخلط بين المسافات (Spaces) وعلامات الجدولة (Tabs) في الملف نفسه — هذا أكثر سبب لأخطاء IndentationError عند المبتدئين.

الأسطر والأوامر

كل سطر = أمر واحد عادةً، ولا حاجة لفاصلة منقوطة ;:

x = 5
y = 10
print(x + y)

التعليقات (Comments)

التعليق نص يتجاهله بايثون، يشرح الكود للبشر. يبدأ بعلامة #:

# هذا تعليق، لن يُنفَّذ
print("مرحبًا")   # تعليق في نهاية السطر

تعليق متعدّد الأسطر

نستخدم سلسلة نصية ثلاثية """ لشرح مطوّل:

"""
هذا شرح يمتد
على عدة أسطر
"""
print("الكود يكمل هنا")

لماذا التعليقات مهمة؟

  • توضيح الكود المعقّد لمن يقرؤه لاحقًا (وأنت بعد شهر!).
  • تعطيل سطر مؤقتًا أثناء التجربة دون حذفه.
  • توثيق نيّتك — لماذا فعلت شيئًا، لا فقط ماذا فعلت.

أخطاء شائعة

  • نسيان المسافة البادئة بعد : — سبب رئيسي للأخطاء.
  • المبالغة في التعليقات لكتابة الواضح (x = 5 # عيّن x بخمسة) — اشرح لماذا لا ماذا.

🎯 التالي: أنواع البيانات — الأرقام والنصوص والمنطقية وكيف نحوّل بينها.