چیزی که از این درس میبری
- گزارش ردگیری خطا با ساختار ErrorType: message پایان میپذیرد؛ همواره ابتدا آن سطر پایانی و سپس شماره سطر بالای آن را بخوانید.
- خطاهای نحو (Syntax Error) پیش از اجرای هر کدی مانع اجرای برنامه میشوند؛ خطاهای زمان اجرا در میانه کار و پس از اجرای سطور قبلی رخ میدهند.
- شش خطای بسیار رایج: NameError، TypeError، ValueError، IndexError، KeyError و ZeroDivisionError.
فهرست این درس۶
۰۱کالبدشکافی ردگیری خطا (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 سطری از ردگیری خطا نمایش داده است. او کدام بخش را باید در وهله نخست مطالعه کند؟
- سطر نخست یعنی Traceback (most recent call last):
- واپسین سطر، حاوی نوع خطا و پیام توضیحی آن
- طولانیترین سطر گزارش
- هیچ بخشی را نخواند و کدنویسی برنامه را از ابتدا آغاز کند
جواب رو ببین
واپسین سطر، حاوی نوع خطا و پیام توضیحی آن
کاملاً درست است. آخرین سطر ماهیت خطا (برای نمونه TypeError) و علت دقیق آن را بازگو میکند؛ و سطر File ... line N درست در بالای آن، محل وقوع خطا را نشان میدهد.
قدمبهقدم ببین

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

۲/۴سطر 3 در بخش + ageبا خطای ناسازگاری str + int متوقف میشودپیکان به سطر 3 میرسد که با علامت ضربدر مشخص میشود. بخش
+ ageبا برچسب str + int مشخص شده است: پایتون تلاش میکند متن "Sara is " را با عملگر + به عدد 30 متصل سازد، اما چنین عملیاتی مجاز نیست؛ در نتیجه اجرای برنامه در همین نقطه متوقف شده و خروجی چاپ نمیشود.
۳/۴تحلیل تریسبک: ابتدا گام 1، سپس گام 2 کارت گزارش خطا با سه ردیف ظاهر میشود: Traceback، line 3 و TypeError. نشانگرهای شمارهدار توالی صحیح مطالعه را نشان میدهند: نشانگر 1 بر روی آخرین سطر یعنی TypeError قرار دارد که ماهیت خطا را بازگو میکند، و نشانگر 2 به line 3 اشاره دارد که محل خطا را مشخص میسازد.

۴/۴اصلاح سطر 3 و چاپ موفق خروجی Sara is 30 سطر 3 با بهرهگیری از یک f-string به صورت
print(f"{name} is {age}")بازنویسی میشود که تبدیل خودکار عدد به متن را انجام میدهد. اکنون هر سه سطر تیک خوردهاند، پنل خروجی عبارت Sara is 30 را نشان میدهد و کارت تریسبک قبلی محو میگردد.
خودت رو امتحان کنسؤال ۲ از ۵
امید برنامهای دو سطری را اجرا میکند: ابتدا print("start") و سپس print(10 / 0). چه خروجی مشاهده خواهد کرد؟
- تنها یک خطا؛ زیرا فایل حاوی اشتباه است و هیچ بخشی اجرا نمیشود
- کلمه start، و سپس گزارشی که به ZeroDivisionError: division by zero ختم میشود
- کلمه start و سپس عدد 0
- کلمه 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 → فراخوانی کلیدی که درون دیکشنری وجود ندارد
خودت رو امتحان کنسؤال ۴ از ۵
total = 10bonus = 5print(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")Next year: 30Please type a numberNext year: 30 Please type a numberNext year: 291
جواب رو ببین
Next year: 30کاملاً درست است. تبدیل int("29") با موفقیت انجام میشود، بنابراین کل بلوک try اجرا شده و از بلوک except صرفنظر میگردد.
۰۵قدمبهقدم
رویه گامبهگام و استاندارد عیبیابی (Debugging)
- مطالعه آخرین سطر گزارش
نوع خطا و شرح ارائهشده مشخص میسازند که باید در جستجوی چه دستهای از مشکلات باشید.
- مراجعه به شماره سطر گزارششده
آن سطر را به دقت بررسی کنید و در صورت بروز خطای نحو، سطر ماقبل آن را نیز از نظر باز ماندن پرانتزها یا گیومهها بازبینی نمایید.
- چاپ مقادیر و نوع متغیرهای درگیر
پیش از سطر خطاساز دستور
print(type(x), x)را بیفزایید تا به جای فرضیات ذهنی، مقادیر و انواع واقعی دادهها را مشاهده کنید. - اعمال یک تغییر در هر گام و آزمون مجدد
ایجاد یک تغییر منفرد در هر مرحله، نقش عامل اصلاحکننده را آشکار میسازد. در صورت عدم حل مشکل، عین عبارت سطر پایانی خطا را جستجو کنید؛ عموماً این مسئله پیشتر توسط دیگران پاسخ داده شده است.
۰۶جمعبندی
مرور درس
- گزارش ردگیری خطا با ساختار ErrorType: message پایان میپذیرد؛ همواره ابتدا آن سطر پایانی و سپس شماره سطر بالای آن را بخوانید.
- خطاهای نحو (Syntax Error) پیش از اجرای هر کدی مانع اجرای برنامه میشوند؛ خطاهای زمان اجرا در میانه کار و پس از اجرای سطور قبلی رخ میدهند.
- شش خطای بسیار رایج: NameError، TypeError، ValueError، IndexError، KeyError و ZeroDivisionError.
- شماره سطر گزارششده محلی است که مفسر متوجه مشکل شده است؛ در خطاهای نحو همواره سطر بالاتر را نیز بررسی کنید.
- ساختار
try / except SomeErrorخطاهای قابل پیشبینی را بدون متوقف ساختن برنامه مهار میکند؛ مانند وارد کردن حروف به جای ارقام توسط کاربر.
به سبک خودت یادش بگیر.
توی اپ از یادآی بخواه این درس رو سادهتر توضیح بده، از زندگی خودت مثال بزنه یا عمیقتر بره. بعد یه مسیر کامل دور هدف خودت بساز.