استراتيجيات تصحيح الأخطاء

طريقان إلى نفس الفكرة

الأساسيات المطلوبة

المفاهيم الأساسية

التصحيح ليس "تخمين ما الخطأ" بل عملية منظّمة: اقرأ الدليل المتاح، كوّن فرضية، اختبرها بأقل تدخّل ممكن، وكرر حتى تصل للسبب الجذري، لا فقط للعرض الظاهري للمشكلة.

الرسم 19: التصحيح حلقة منظّمة لا تخمين عشوائي: كل فرضية فاشلة تضيف معلومة جديدة تقرّبك من السبب الحقيقي.

مثال تطبيقي: دالة حساب متوسط تنهار بصمت

لنتتبّع نفس الخطأ بأربع أدوات مختلفة، من الأبسط للأعمق:

## الكود المعطوب — لا تستطيع رؤية الخطأ بالعين مباشرة
def calculate_average(scores):
    total = sum(scores)
    return total / len(scores)

def process_batch(all_scores):
    results = []
    for student_scores in all_scores:
        results.append(calculate_average(student_scores))
    return results

batches = [[90, 85, 88], [70, 75], []]   # الطالب الثالث بلا درجات!
print(process_batch(batches))

1️⃣ قراءة Traceback

Traceback (most recent call last):
  File "report.py", line 11, in <module>
    print(process_batch(batches))
  File "report.py", line 8, in process_batch
    results.append(calculate_average(student_scores))
  File "report.py", line 3, in calculate_average
    return total / len(scores)
ZeroDivisionError: division by zero

اقرأه من الأسفل: ZeroDivisionError في السطر 3 داخل calculate_average‏. السبب الجذري الحقيقي أعلى في السلسلة: قائمة [] فارغة وصلت أساسًا من batches‏.

الرسم 20: نفس استدعاء calculate_average يتكرر ثلاث مرات بنفس المنطق؛ الانهيار يظهر فقط في الاستدعاء الثالث، لكن مصدر المشكلة الحقيقي أعلى في السلسلة، داخل batches نفسها.

2️⃣ Print Debugging

def calculate_average(scores):
    print("DEBUG scores =", scores)   # تحقق سريع من القيمة الفعلية
    total = sum(scores)
    return total / len(scores)

3️⃣ pdb التفاعلي

def calculate_average(scores):
    breakpoint()        # البرنامج يتوقف هنا تمامًا، يعطيك سطر أوامر (pdb)
    total = sum(scores)
    return total / len(scores)
## داخل pdb: اكتب p scores لرؤية القيمة، n للسطر التالي، c للمتابعة

داخل جلسة pdb التفاعلية، أهم الأوامر: p <var> لطباعة قيمة متغيّر في لحظتها الحقيقية، n (next) لتنفيذ السطر التالي دون الدخول في الدوال المستدعاة، s (step) للدخول داخل الدالة المستدعاة خطوة بخطوة، و c (continue) لاستكمال التنفيذ العادي حتى نقطة توقف تالية أو نهاية البرنامج. الفرق الجوهري عن print: تستطيع أن تفحص أي متغيّر تخطر لك فكرته لحظيًا دون تعديل الكود أو إعادة التشغيل من جديد.

4️⃣ Logging احترافي بدل الطباعة

import logging
logging.basicConfig(level=logging.DEBUG, format="%(levelname)s: %(message)s")

def calculate_average(scores):
    logging.debug(f"scores={scores}")
    if not scores:
        logging.warning("قائمة درجات فارغة — سيتم تجاهل هذا الطالب")
        return 0.0
    return sum(scores) / len(scores)

مثال محلول

خرافة مقابل حقيقة

أين تُستخدم هذه الاستراتيجيات فعليًا؟

جرّب بنفسك

بطاقات مراجعة سريعة

اختبر فهمك