مقدمة
حتى الآن تعلمنا أن البرنامج يتكون من:
- متغيرات تخزن البيانات.
- أنواع بيانات تحدد طبيعة المعلومات.
- عمليات لمعالجة البيانات.
- إدخال وإخراج للتواصل مع المستخدم.
لكن عندما تبدأ بكتابة برامج أكبر، ستواجه مشكلة مهمة:
كيف تتذكر وظيفة كل جزء من الكود بعد مرور وقت طويل؟
وكيف يفهم مبرمج آخر البرنامج إذا شاركك العمل؟
هنا يأتي دور التعليقات (Comments).
التعليقات هي ملاحظات يكتبها المبرمج داخل ملف الكود لتوضيح ما يحدث، لكنها لا يتم تنفيذها من قبل البرنامج.
---
ما هي التعليقات؟
التعليق هو نص يكتبه المبرمج داخل الكود بهدف الشرح والتوضيح، وتتجاهله Python أثناء تشغيل البرنامج.
بمعنى آخر:
البرنامج يقرأ الأوامر البرمجية فقط، أما التعليقات فيتجاوزها ولا يعتبرها جزءًا من التنفيذ.
---
لماذا نستخدم التعليقات؟
قد يظن المبتدئ أن التعليقات غير مهمة، لأن البرنامج يعمل بدونها.
لكن في المشاريع الحقيقية تصبح التعليقات مفيدة جدًا.
فهي تساعد على:
- فهم الكود بسرعة.
- تذكر سبب كتابة جزء معين.
- شرح الأفكار المعقدة.
- تسهيل العمل بين أعضاء الفريق.
- تنظيم الملفات البرمجية.
---
مثال من الحياة اليومية
تخيل أنك تملك كتابًا كبيرًا.
بعد فترة طويلة عدت لقراءته، ووجدت أنك كتبت ملاحظات بجانب بعض الصفحات تشرح الأفكار المهمة.
هذه الملاحظات لا تغير محتوى الكتاب، لكنها تساعدك على فهمه بسرعة.
التعليقات في البرمجة تعمل بالطريقة نفسها.
فهي لا تغير البرنامج، لكنها تساعد الإنسان على فهمه.
---
هل الكمبيوتر يقرأ التعليقات؟
لا.
عندما تقوم Python بتشغيل البرنامج، فإنها تتجاهل التعليقات تمامًا.
فهي موجودة للمبرمجين فقط، وليس للحاسوب.
وهذا يعني أن كتابة تعليق جيد لا تجعل البرنامج يعمل بشكل مختلف، لكنها تجعل الكود أسهل للفهم.
---
لماذا يحتاج المبرمج المحترف إلى التعليقات؟
عندما تكتب برنامجًا صغيرًا، قد تتذكر كل شيء بسهولة.
لكن تخيل مشروعًا يحتوي على:
- آلاف الأسطر البرمجية.
- عشرات الملفات.
- أكثر من مبرمج يعمل عليه.
بعد أشهر، قد لا تتذكر لماذا كتبت جزءًا معينًا من الكود.
هنا تساعد التعليقات على توضيح الأفكار المهمة وتوفير الوقت.
---
هل نكتب تعليقًا على كل سطر؟
لا.
هذه من الأخطاء التي يقع فيها المبتدئون.
ليس الهدف من التعليقات شرح الأشياء الواضحة جدًا.
فمثلًا، كتابة تعليق يقول:
"هذا المتغير يخزن الرقم 5"
قد لا يكون مفيدًا.
لكن شرح سبب استخدام طريقة معينة أو توضيح فكرة معقدة يكون أكثر فائدة.
---
ما الفرق بين الكود والتعليق؟
الكود:
- ينفذه الحاسوب.
- يغير البيانات.
- ينفذ الأوامر.
التعليق:
- لا ينفذه الحاسوب.
- لا يغير أي شيء.
- يشرح الكود للإنسان فقط.
وهذا الفرق مهم جدًا لفهم وظيفة التعليقات.
---
أين تستخدم التعليقات؟
يمكن استخدامها في أماكن كثيرة، مثل:
- شرح وظيفة برنامج كامل.
- توضيح هدف دالة معينة.
- شرح خوارزمية معقدة.
- كتابة ملاحظات للمطورين الآخرين.
- تذكير نفسك بأشياء تحتاج إلى تعديلها لاحقًا.
---
أخطاء شائعة عند استخدام التعليقات
من الأخطاء الشائعة:
- كتابة تعليقات كثيرة جدًا تجعل الكود مزدحمًا.
- كتابة تعليقات لا تطابق الكود بعد تعديل البرنامج.
- استخدام التعليقات بدل كتابة كود واضح.
فالهدف من التعليقات هو المساعدة، وليس تعويض التنظيم الجيد للكود.
---
لماذا تعد التعليقات مهارة مهمة؟
قد تبدو التعليقات موضوعًا بسيطًا، لكنها تعكس طريقة تفكير المبرمج.
المبرمج الجيد لا يهتم فقط بأن يعمل البرنامج، بل يهتم أيضًا بأن يكون الكود مفهومًا ومنظمًا.
وهذا يصبح مهمًا جدًا عند بناء مشاريع كبيرة.
---
ملخص الدرس
تعلمنا أن التعليقات (Comments) هي ملاحظات يكتبها المبرمج داخل الكود لتوضيح الأفكار وشرح الأجزاء المهمة، وأن Python تتجاهلها أثناء تشغيل البرنامج. كما عرفنا أن التعليقات تساعد على تنظيم المشاريع، وتسهيل قراءة الكود، والتعاون بين المبرمجين.
في الدرس السادس سنتعرف على التحويل بين أنواع البيانات (Type Casting)، وسنفهم كيف نحول البيانات من نوع إلى آخر، ولماذا يحتاج البرنامج أحيانًا إلى تغيير طريقة تخزين المعلومات.