أساسيات بايثون (4): التعليقات Python Comments

 مرحباً بك في الدرس الرابع من دورتنا الشيقة لتعلم أساسيات بايثون! 🎉

📌 الدرس السابق: تعلمنا كيف أن المسافات البادئة (Indentation) هي حجر الأساس في بناء جملة بايثون.

💻 تطبيق فوري: ولا تنسَ أن تجرب كل الأكواد بنفسك فوراً على محرر بايثون العرب لتطبق ما تتعلمه دون الحاجة لتنزيل أي شيء.

اليوم سنتحدث عن عنصر لا يقل أهمية، بل هو رفيقك الدائم في رحلة البرمجة: التعليقات (Comments). 🗣️📝

🤔 ما هي التعليقات ولماذا هي مهمة جداً؟

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

بكل بساطة، التعليقات هي أجزاء من الكود يتجاهلها مفسر بايثون تماماً. يراها المبرمج فقط، ولا يتم تنفيذها. إنها مثل الهمسات التي تتركها في ثنايا الكود لتروي قصته. 📖

🌟 استخدامات التعليقات السحرية:

• 📝 شرح الكود: توضيح وظيفة جزء معقد من الكود.
• 🧹 جعل الكود أكثر وضوحاً: عندما تقرأ الكود بعد فترة، ستشكر نفسك.
• 🚫 منع تنفيذ الكود: أثناء الاختبار، يمكنك تعطيل سطر مؤقتاً دون حذفه.
• 📚 كتابة توثيق (Documentation): شرح دوال وصنوف بشكل احترافي (سنعرفها لاحقاً).

🥚 1. إنشاء تعليق – سحر علامة #

في بايثون، التعليق يبدأ بعلامة الشباك # (hash). كل ما يأتي بعد هذه العلامة على نفس السطر يتحول إلى "نص سحري" لا تنفذه بايثون. 🪄

المثال الأول:

# This is a simple comment! Python will ignore it completely
print("Hello, World!")  # This code will run

عند تشغيل الكود، ستظهر لك فقط Hello, World! وكأن التعليق غير موجود أصلاً. أليس هذا رائعاً؟ 😍

📍 2. تعليقات في نهاية السطر

يمكن وضع التعليق بعد كود حقيقي على نفس السطر. كل ما بعد # يُعتبر تعليقاً.

print("Python rocks!")  # Print a motivational message
x = 10  # Assign the value 10 to the variable x

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

🚫 3. استخدام التعليقات لتعطيل الكود مؤقتاً

كم مرة أردت أن تجرب شيئاً دون حذف الكود القديم؟ هنا يأتي دور التعليقات كـ "زر إيقاف مؤقت". ⏸️

print("This line will run")

# print("This line will NOT run temporarily!")
# Because it has been turned into a comment

print("This line will also run")

عند التشغيل، سترى السطرين الأول والثالث فقط. هذه الخدعة رائعة عند تصحيح الأخطاء (Debugging) وتجربة حلول مختلفة. لا تخف من تعطيل الأكواد، فالتعليقات هي ملاذك الآمن! 🛡️

📜 4. التعليقات متعددة الأسطر (Multi-Line Comments)

هنا الجزء الممتع! ماذا لو أردت كتابة تعليق طويل يشرح خوارزمية معقدة أو يوثق فكرة؟ بايثون ليس لديها صيغة خاصة للتعليقات متعددة الأسطر مثل /* ... */ في لغات أخرى. لكن لدينا حيلتين بايثونيتين رائعتين. 🐍🎩

🐢 الطريقة الأولى: وضع # في بداية كل سطر

# This is a very long comment
# that explains why the algorithm was implemented
# this way instead of the other way.
# It is explicit and clear!
print("Code is running!")

هذه الطريقة مثالية، لكنها تتطلب كتابة # في كل سطر. ماذا لو كان التعليق 30 سطراً؟ 😅 حسناً، المحررات الحديثة (مثل VS Code) تسمح لك بتحديد عدة أسطر والضغط على Ctrl + / لتحويلها كلها إلى تعليقات أو إلغاء التعليق دفعة واحدة. جربها! 🖱️

🥚 الطريقة الثانية (سرية): استخدام السلاسل النصية متعددة الأسطر (Triple Quotes)

في بايثون، أي سلسلة نصية (String) غير مخصصة لمتغير أو لا يتم استخدامها في أي عملية، تتجاهلها بايثون تماماً أثناء التنفيذ. هذا يعني أنه يمكنك كتابة نص طويل بين ثلاث علامات اقتباس """...""" أو '''...''' وسيعمل كتعليق!

"""
This is a very long comment
written using triple-quoted strings.
It can span multiple lines
without needing a # on each line.
Amazing, isn't it?
"""
print("Code is running!")

⚠️ انتباه ذكي: تقنياً، هذا ليس تعليقاً حقيقياً، بل هو سلسلة نصية حرفية (String Literal) يتم إنشاؤها ثم إهمالها. لكن لماذا تعمل؟ لأن بايثون تنشئ الكائن النصي ثم لا تسنده لأي متغير، فيختفي من الذاكرة. لهذا السبب هي حيلة مقبولة ومستخدمة بكثرة.

🧠 أفضل الممارسات – متى تستخدم التعليقات ومتى تتجنبها؟

التعليقات رائعة، لكن الكود النظيف يشرح نفسه. لا تسيء استخدام التعليقات لتوضيح ما هو واضح، فهذا يزيد الضوضاء. 🙉

❌ تعليق يشرح ما هو واضح امام العين :

x = x + 1  # Increment x by 1

هذا التعليق لا يضيف شيئاً. الكود يشرح نفسه أنا أرى أكس يساوي أكس زائد واحد يعني زيادة بمقدار واحد.

✅ تعليق جيد (يشرح "لماذا" وليس "ماذا"):

x = x + 1  # Compensate for the offset from time zero in the simulation

هنا أنت تشرح السبب المنطقي، مما يساعد القارئ على فهم السياق. 🧩

✅ تعليق ممتاز لتقسيم الكود:

# ==========================================
# Phase 1: Load and clean the data
# ==========================================
df = load_data()
df = clean_data(df)

# ==========================================
# Phase 2: Build the model
# ==========================================
model = build_model()

هذه التعليقات البصرية تجعل التنقل في الملفات الطويلة ممتعاً وسلساً. 🗺️

🎓 خلاصة الدرس الرابع

اليوم تعلمنا أن التعليقات هي أفضل صديق للمبرمج الذكي. 🤝 فهي:

• تبدأ بعلامة # وتجعل بايثون تتجاهل كل ما بعدها.
• تستخدم لشرح الكود، أو منع تنفيذه مؤقتاً.
• في التعليقات متعددة الأسطر، نستخدم إما # في كل سطر، أو نستخدم خدعة السلاسل النصية """...""" ولكن بحذر.
• التعليق الجيد يشرح "لماذا" وليس "ماذا".

في الدرس القادم، سنبدأ رحلتنا مع أحد أهم الكنوز: 🧮 Python Variables (المتغيرات)! ستتعلم كيف تخزن البيانات بأسماء جميلة، وكيف تتعامل مع أنواع البيانات المختلفة بطريقة بايثونية ساحرة. لا تفوته! 😉🔥