پث‌وایز

مقدمه‌ای بر برنامه‌نویسی با پایتوندرس ۱۰ از ۱۲

خواندن و تفسیر پیام‌های خطا

پیام خطا راهنمایی مفسر پایتون برای تعیین محل دقیق توقف و علت بروز مشکل است. در این درس خواندن گزارش ردگیری خطا (Traceback) از پایین به بالا، شناخت شش خطای بسیار شایع و مهار خطاهای قابل پیش‌بینی با ساختار try و except را فرا می‌گیرید.

چیزی که از این درس می‌بری

  • گزارش ردگیری خطا با ساختار ErrorType: message پایان می‌پذیرد؛ همواره ابتدا آن سطر پایانی و سپس شماره سطر بالای آن را بخوانید.
  • خطاهای نحو (Syntax Error) پیش از اجرای هر کدی مانع اجرای برنامه می‌شوند؛ خطاهای زمان اجرا در میانه کار و پس از اجرای سطور قبلی رخ می‌دهند.
  • شش خطای بسیار رایج: NameError، TypeError، ValueError، IndexError، KeyError و ZeroDivisionError.
فهرست این درس۶
  1. ابتدا آخرین سطر را بخوانید
  2. تمایز دو دسته خطای بنیادین
  3. شش خطای بسیار متداول برای برنامه‌نویسان
  4. مهار خطاهای قابل پیش‌بینی
  5. رویه گام‌به‌گام و استاندارد عیب‌یابی (Debugging)
  6. مرور درس

۰۱کالبدشکافی ردگیری خطا (Traceback)

ابتدا آخرین سطر را بخوانید

هنگامی که برنامه‌ای دچار توقف غیرمنتظره می‌شود، پایتون گزارش ردگیری یا تریس‌بک (Traceback) صادر می‌کند. این گزارش با عبارت Traceback (most recent call last): آغاز می‌شود، سپس زنجیره فراخوانی‌های فعال را به صورت File "...", line N به همراه سطر کد مربوطه در زیر آن فهرست می‌کند. واپسین سطر حیاتی‌ترین بخش گزارش است: این سطر نوع خطا و شرح آن را مشخص می‌سازد؛ نظیر TypeError: can only concatenate str (not "int") to str. همواره ابتدا این سطر را بخوانید تا بدانید چه مشکلی رخ داده، و سپس شماره سطر مندرج در بالای آن را بررسی کنید تا دریابید خطا در کجا اتفاق افتاده است.

اگر تابعی تابع دیگری را فراخوانده باشد، به ازای هر فراخوانی یک سطر File مشاهده خواهید کرد؛ درست همانند قاب‌های پشته فراخوانی. سطر پایانی دقیقاً نقطه‌ای است که برنامه در آن دچار شکست شده است.

مثال

name = "Sara"
age = 30
print(name + " is " + age)

خروجی

Traceback (most recent call last):
  File "/home/sara/app.py", line 3, in <module>
    print(name + " is " + age)
          ~~~~~~~~~~~~~~^~~~~
TypeError: can only concatenate str (not "int") to str

این گزارش خروجی پایتون 3.11 هنگام اجرای فایلی در مسیر فرضی است؛ سطر File مسیر فایل در رایانه شما را نشان می‌دهد. در نسخه‌های 3.10 و قدیمی‌تر علامت‌های تأکیدی زیر کد رسم نمی‌شوند، اما ساختار متن یکسان است. سطر پایانی: ماهیت خطا (الحاق رشته با عدد). سطر 3 (line 3): محل وقوع خطا.

خودت رو امتحان کنسؤال ۱ از ۵

برنامه نگار متوقف شده و گزارشی 10 سطری از ردگیری خطا نمایش داده است. او کدام بخش را باید در وهله نخست مطالعه کند؟

  1. سطر نخست یعنی Traceback (most recent call last):
  2. واپسین سطر، حاوی نوع خطا و پیام توضیحی آن
  3. طولانی‌ترین سطر گزارش
  4. هیچ بخشی را نخواند و کدنویسی برنامه را از ابتدا آغاز کند
جواب رو ببین

واپسین سطر، حاوی نوع خطا و پیام توضیحی آن

کاملاً درست است. آخرین سطر ماهیت خطا (برای نمونه TypeError) و علت دقیق آن را بازگو می‌کند؛ و سطر File ... line N درست در بالای آن، محل وقوع خطا را نشان می‌دهد.

قدم‌به‌قدم ببین

  1. سطرهای 1 و 2 بدون هیچ مشکلی اجرا می‌شوند
    ۱/۴سطرهای 1 و 2 بدون هیچ مشکلی اجرا می‌شوند

    برنامه سه‌سطری به همراه شماره سطرهایش نمایش داده شده است. پیکان اجرا از سطر 1 عبور کرده و روی سطر 2 متوقف است و هر دو علامت تیک دریافت کرده‌اند: انتساب مقادیر "Sara" و 30 با موفقیت انجام شده است. سطر 3 هنوز اجرا نشده، بنابراین پنل خروجی خالی است.

  2. سطر 3 در بخش + age با خطای ناسازگاری str + int متوقف می‌شود
    ۲/۴سطر 3 در بخش + age با خطای ناسازگاری str + int متوقف می‌شود

    پیکان به سطر 3 می‌رسد که با علامت ضربدر مشخص می‌شود. بخش + age با برچسب str + int مشخص شده است: پایتون تلاش می‌کند متن "Sara is " را با عملگر + به عدد 30 متصل سازد، اما چنین عملیاتی مجاز نیست؛ در نتیجه اجرای برنامه در همین نقطه متوقف شده و خروجی چاپ نمی‌شود.

  3. تحلیل تریس‌بک: ابتدا گام 1، سپس گام 2
    ۳/۴تحلیل تریس‌بک: ابتدا گام 1، سپس گام 2

    کارت گزارش خطا با سه ردیف ظاهر می‌شود: Traceback، line 3 و TypeError. نشانگرهای شماره‌دار توالی صحیح مطالعه را نشان می‌دهند: نشانگر 1 بر روی آخرین سطر یعنی TypeError قرار دارد که ماهیت خطا را بازگو می‌کند، و نشانگر 2 به line 3 اشاره دارد که محل خطا را مشخص می‌سازد.

  4. اصلاح سطر 3 و چاپ موفق خروجی Sara is 30
    ۴/۴اصلاح سطر 3 و چاپ موفق خروجی Sara is 30

    سطر 3 با بهره‌گیری از یک f-string به صورت print(f"{name} is {age}") بازنویسی می‌شود که تبدیل خودکار عدد به متن را انجام می‌دهد. اکنون هر سه سطر تیک خورده‌اند، پنل خروجی عبارت Sara is 30 را نشان می‌دهد و کارت تریس‌بک قبلی محو می‌گردد.

خودت رو امتحان کنسؤال ۲ از ۵

امید برنامه‌ای دو سطری را اجرا می‌کند: ابتدا print("start") و سپس print(10 / 0). چه خروجی مشاهده خواهد کرد؟

  1. تنها یک خطا؛ زیرا فایل حاوی اشتباه است و هیچ بخشی اجرا نمی‌شود
  2. کلمه start، و سپس گزارشی که به ZeroDivisionError: division by zero ختم می‌شود
  3. کلمه start و سپس عدد 0
  4. کلمه start و هیچ خروجی دیگری
جواب رو ببین

کلمه start، و سپس گزارشی که به ZeroDivisionError: division by zero ختم می‌شود

کاملاً درست است. تقسیم بر صفر یک خطای زمان اجرا (Runtime Error) است: پایتون تنها هنگامی متوجه آن می‌شود که به سطر دوم برسد؛ بنابراین سطر نخست از پیش با موفقیت اجرا شده و کلمه start را چاپ کرده است.

تمایز دو دسته خطای بنیادین

خطای نوشتاری (Syntax Error): پیش از اجرای هر کدی

ساختار کد منطبق بر قواعد نگارشی زبان پایتون نیست: جا افتادن دونقطه، پرانتز یا گیومه، یا نوشتن = به جای == در دستور شرطی. مفسر ابتدا کل فایل را بررسی نحوی می‌کند و با یافتن خطا، هیچ سطری را اجرا نمی‌کند (حتی سطور سالم بالای خطا).

انواع شایع: SyntaxError و خطای ناهمگونی تورفتگی‌ها IndentationError.

خطای زمان اجرا (Runtime Error): در حین اجرای برنامه

نگارش کد از نظر دستوری صحیح است، اما اجرای یک گام با مقادیر موجود امکان‌پذیر نیست: مانند تقسیم بر صفر، فراخوانی کلید ناموجود، یا جمع متن با عدد.

تمامی سطرهای پیش از نقطه خطا با موفقیت اجرا شده‌اند، بنابراین ممکن است بخشی از خروجی‌ها پیش از توقف چاپ شوند.

مثال

print("hi")
x = 5
if x > 3
    print("big")

خروجی

  File "/home/sara/app.py", line 3
    if x > 3
            ^
SyntaxError: expected ':'

یک خطای نوشتاری: اثری از سرتیتر Traceback نیست و کلمه hi هرگز چاپ نمی‌شود (با وجود آنکه سطر 1 کاملاً بی‌نقص است)؛ چرا که پایتون اساساً آغاز اجرای برنامه را نپذیرفت. علامت ^ موقعیت دقیق دونقطه مفقود را نشان می‌دهد.

شش خطای بسیار متداول برای برنامه‌نویسان

  • NameError: name 'totl' is not defined: ناشی از اشتباه تایپی در نام متغیر یا استفاده از نام پیش از مقداردهی.
  • TypeError: can only concatenate str (not "int") to str: ناسازگاری انواع داده‌ها در عملیات؛ استفاده از f-string یا str() راهکار آن است.
  • ValueError: invalid literal for int() with base 10: 'abc': نوع داده متنی درست است، اما محتوای آن قابل تبدیل به عدد توسط تابع int() نیست.
  • IndexError: list index out of range: ارجاع به اندیسی فراتر از دامنه لیست؛ آخرین اندیس مجاز len - 1 است.
  • KeyError: 'coffee': ارجاع به کلیدی که در دیکشنری موجود نیست؛ با عملگر in بررسی کنید یا از متد get بهره ببرید.
  • ZeroDivisionError: division by zero: تقسیم عدد بر صفر، که معمولاً ناشی از متغیری است که در محاسبات مقدار صفر گرفته است.

خودت رو امتحان کنسؤال ۳ از ۵

هر نوع خطا را به علت شایع بروز آن متصل کنید

  • NameError
  • TypeError
  • IndexError
  • KeyError

استفاده از نامی که تعریف نشده است، معمولاً ناشی از اشتباه تایپیدرخواست موقعیتی فراتر از طول و انتهای یک لیستفراخوانی کلیدی که درون دیکشنری وجود نداردناسازگاری نوع داده برای عملیات مدنظر، مانند جمع متن با عدد

جواب رو ببین
  • NameError → استفاده از نامی که تعریف نشده است، معمولاً ناشی از اشتباه تایپی
  • TypeError → ناسازگاری نوع داده برای عملیات مدنظر، مانند جمع متن با عدد
  • IndexError → درخواست موقعیتی فراتر از طول و انتهای یک لیست
  • KeyError → فراخوانی کلیدی که درون دیکشنری وجود ندارد

خودت رو امتحان کنسؤال ۴ از ۵

  1. total = 10
  2. bonus = 5
  3. print(totl + bonus)
جواب رو ببین

اشکال توی خط ۳.

کاملاً درست تشخیص دادید. عبارت totl یک اشتباه تایپی برای total است. مفسر پایتون با خطای NameError: name 'totl' is not defined متوقف می‌شود و در نسخه‌های جدید حتی پیشنهاد می‌دهد: Did you mean: 'total'?

۰۴مدیریت خطا با try و except

مهار خطاهای قابل پیش‌بینی

برخی خطاها ناشی از باگ کدنویسی نیستند، بلکه پیامد ورودی‌های نامعتبر کاربرانند. چنانچه از کاربری سن او پرسیده شود و او عبارت abc را وارد کند، فراخوانی int(...) خطای ValueError تولید می‌کند. سطوح پرخطر را زیر بلوک try: قرار دهید و رفتار جایگزین را ذیل except ValueError: بنویسید. چنانچه کدهای بلوک try با موفقیت اجرا شوند، بلوک except نادیده گرفته می‌شود؛ اما در صورت بروز ValueError، مفسر پایتون به جای فروپاشی برنامه، به اجرای کدهای except می‌پردازد. همواره نام خطای مشخصی را که انتظارش را دارید قید کنید تا باگ‌های دیگر پنهان نمانند.

در برنامه‌های واقعی داده از دستور age = int(input("Age? ")) دریافت می‌شود؛ در نمونه‌های آموزشی از متغیر ثابت استفاده شده تا خروجی قطعی باشد.

مثال

text = "abc"
try:
    age = int(text)
    print("Next year:", age + 1)
except ValueError:
    print("Please type a number")

خروجی

Please type a number

دستور int("abc") در نخستین سطر بلوک try با شکست مواجه می‌شود، بنابراین دستور print زیر آن اجرا نشده و پایتون مستقیماً به بلوک except هدایت می‌شود. هیچ گزارش خطایی صادر نمی‌شود و اجرای برنامه تداوم می‌یابد.

خودت رو امتحان کنسؤال ۵ از ۵

text = "29"
try:
    age = int(text)
    print("Next year:", age + 1)
except ValueError:
    print("Please type a number")
  1. Next year: 30
  2. Please type a number
  3. Next year: 30
    Please type a number
  4. Next year: 291
جواب رو ببین
Next year: 30

کاملاً درست است. تبدیل int("29") با موفقیت انجام می‌شود، بنابراین کل بلوک try اجرا شده و از بلوک except صرف‌نظر می‌گردد.

۰۵قدم‌به‌قدم

رویه گام‌به‌گام و استاندارد عیب‌یابی (Debugging)

  1. مطالعه آخرین سطر گزارش

    نوع خطا و شرح ارائه‌شده مشخص می‌سازند که باید در جستجوی چه دسته‌ای از مشکلات باشید.

  2. مراجعه به شماره سطر گزارش‌شده

    آن سطر را به دقت بررسی کنید و در صورت بروز خطای نحو، سطر ماقبل آن را نیز از نظر باز ماندن پرانتزها یا گیومه‌ها بازبینی نمایید.

  3. چاپ مقادیر و نوع متغیرهای درگیر

    پیش از سطر خطاساز دستور print(type(x), x) را بیفزایید تا به جای فرضیات ذهنی، مقادیر و انواع واقعی داده‌ها را مشاهده کنید.

  4. اعمال یک تغییر در هر گام و آزمون مجدد

    ایجاد یک تغییر منفرد در هر مرحله، نقش عامل اصلاح‌کننده را آشکار می‌سازد. در صورت عدم حل مشکل، عین عبارت سطر پایانی خطا را جستجو کنید؛ عموماً این مسئله پیش‌تر توسط دیگران پاسخ داده شده است.

۰۶جمع‌بندی

مرور درس

  • گزارش ردگیری خطا با ساختار ErrorType: message پایان می‌پذیرد؛ همواره ابتدا آن سطر پایانی و سپس شماره سطر بالای آن را بخوانید.
  • خطاهای نحو (Syntax Error) پیش از اجرای هر کدی مانع اجرای برنامه می‌شوند؛ خطاهای زمان اجرا در میانه کار و پس از اجرای سطور قبلی رخ می‌دهند.
  • شش خطای بسیار رایج: NameError، TypeError، ValueError، IndexError، KeyError و ZeroDivisionError.
  • شماره سطر گزارش‌شده محلی است که مفسر متوجه مشکل شده است؛ در خطاهای نحو همواره سطر بالاتر را نیز بررسی کنید.
  • ساختار try / except SomeError خطاهای قابل پیش‌بینی را بدون متوقف ساختن برنامه مهار می‌کند؛ مانند وارد کردن حروف به جای ارقام توسط کاربر.

به سبک خودت یادش بگیر.

توی اپ از یادآی بخواه این درس رو ساده‌تر توضیح بده، از زندگی خودت مثال بزنه یا عمیق‌تر بره. بعد یه مسیر کامل دور هدف خودت بساز.

Cafe Bazaar Myket توی اپ شخصی‌سازیش کن