KAHIBARO Bookshelves
Discord Login Register

11.2. خواندن پیام‌های خطا

چرا خواندن پیام خطا مهم است؟

پیام‌های خطا (Error Messages) در پایتون شبیه «نقشهٔ گنج» هستند:
به شما می‌گویند کجا و تقریباً چه چیزی اشتباه است.
مبتدی‌ها معمولاً وقتی خطا می‌بینند می‌ترسند و فقط دکمهٔ اجرا را دوباره می‌زنند؛
ولی برنامه‌نویس خوب کسی است که پیام خطا را می‌خواند و تفسیر می‌کند.

در این بخش تمرکز ما روی این است که:

  • ساختار کلی پیام خطای پایتون را بشناسید.
  • بتوانید از روی پیام، خط و بخش مشکل‌دار کد را پیدا کنید.
  • متوجه شوید نوع خطا چه سرنخی به شما می‌دهد.
  • یاد بگیرید از متن خطا در گوگل/چت‌جی‌پی‌تی استفاده کنید.

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


ساختار کلی پیام خطای پایتون (Traceback)

وقتی برنامه‌ٔ شما در پایتون خطا می‌دهد، معمولاً چیزی شبیه این می‌بینید:

Traceback (most recent call last):
  File "test.py", line 3, in <module>
    x = 10 / 0
ZeroDivisionError: division by zero

تقریباً همهٔ پیام‌های خطا این ساختار را دارند:

  1. خط اول: Traceback (most recent call last):
    یعنی «ردیابی (تاریخچه) فراخوانی‌ها از جدیدترین مورد».
  2. چند خط «مکان خطا»
    • فایل کجاست (File "test.py")
    • در کدام خط (line 3)
    • در کدام بخش (in <module> یا نام تابع)
    • خود خط کد (x = 10 / 0)
  3. خط آخر: نوع خطا و توضیح کوتاه
    • نوع خطا: ZeroDivisionError
    • توضیح: division by zero

مهم‌ترین بخش‌ها برای شما:

  • شمارهٔ خط: تا بدانید کجا را باید نگاه کنید.
  • نوع خطا: سرنخ اصلی از اینکه چه چیزی «نوعاً» مشکل دارد.
  • توضیح کوتاه: معمولاً جمله‌ای انگلیسی که معنی‌اش نسبتاً ساده است.

پیدا کردن خط مشکل‌دار از روی پیام خطا

مثال:

Traceback (most recent call last):
  File "main.py", line 5, in <module>
    print("نتیجه:", reslt)
NameError: name 'reslt' is not defined

چطور بخوانیم؟

  1. فایل: main.py
  2. خط: line 5
  3. کد در آن خط: print("نتیجه:", reslt)
  4. نوع خطا: NameError
  5. توضیح: name 'reslt' is not defined

از این اطلاعات چه نتیجه می‌گیریم؟

  • سرنخ ۱: NameError یعنی مشکلی با نام متغیر/چیز استفاده‌شده وجود دارد.
  • سرنخ ۲: متن: 'reslt' is not defined
    یعنی متغیر reslt قبلاً تعریف نشده، یا اشتباه تایپی است.

احتمالاً می‌خواستید بنویسید result نه reslt.


مثال‌های رایج و نحوهٔ خواندن آن‌ها

در این بخش چند نمونهٔ رایج از پیام‌های خطا و روش خواندن‌شان را می‌بینید.
هدف این نیست که همهٔ این نوع‌ها را عمیقاً یاد بگیرید،
بلکه یاد بگیرید چطور از خود پیام «سرنخ» بگیرید.

۱. SyntaxError (مشکل در نوشتن دستور)

File "test.py", line 2
    if x > 10
             ^
SyntaxError: invalid syntax

نکات:

  • خط: line 2
  • نوع: SyntaxError
  • علامت ^ زیر‌نویس: جایی را که پایتون «مشکوک» است نشان می‌دهد.
  • پیام: invalid syntax یعنی «دستور نوشتاری درست نیست».

این‌جا مشکل: بعد از if x > 10 دو‌نقطه : جا افتاده است.

ترفند: همیشه دنبال ^ (کلاهک) در پیام باشید؛
گاهی دقیقاً همان‌جاست، گاهی یک کاراکتر قبل یا بعدش.

۲. IndentationError (مشکل تورفتگی)

File "test.py", line 3
    print("Hello")
    ^
IndentationError: unexpected indent
  • نوع: IndentationError
  • پیام: unexpected indent یعنی «تورفتگی غیرمنتظره».

مشخص است که در خط ۳، فاصله/تب اشتباه است.
باید ببینید آیا خطی که تورفته، واقعاً باید داخل یک بلوک (if، for، …) باشد یا نه.

۳. NameError (نام ناشناخته)

File "calc.py", line 4, in <module>
    print(result)
NameError: name 'result' is not defined
  • نوع: NameError
  • پیام: name 'result' is not defined

به‌طور کلی:

  • متغیر را اشتباه نوشته‌اید.
  • یا قبل از استفاده، آن را مقداردهی نکرده‌اید.
  • یا در محدوده‌ای (scope) هستید که به آن دسترسی ندارید (جزئیات در فصل توابع).

۴. TypeError (نوع داده نامناسب)

File "app.py", line 6, in <module>
    print("جمع:", 5 + "3")
TypeError: unsupported operand type(s) for +: 'int' and 'str'
  • نوع: TypeError
  • پیام: unsupported operand type(s) for +: 'int' and 'str'
    یعنی عملگر + بین int و str پشتیبانی نمی‌شود.

اینجا 5 عدد است و "3" رشته؛ باید یا تبدیل نوع کنید، یا روش دیگری استفاده کنید.

۵. ValueError (مقدار نامعتبر)

File "app.py", line 3, in <module>
    age = int("abc")
ValueError: invalid literal for int() with base 10: 'abc'
  • نوع: ValueError
  • پیام: invalid literal for int() ... 'abc'
    یعنی مقدار 'abc' برای تبدیل به عدد صحیح معتبر نیست.

معمولاً:

  • ورودی کاربر را به عدد تبدیل می‌کنید و او چیزی غیرعددی می‌نویسد.
  • باید ورودی را بررسی کنید یا پیام مناسب بدهید.

۶. IndexError و KeyError

IndexError (ایندکس خارج از محدوده)

nums = [1, 2, 3]
print(nums[5])

پیام:

IndexError: list index out of range
  • یعنی به اندیس (index) ای دسترسی می‌خواهید که در لیست وجود ندارد.

KeyError (کلید ناموجود در دیکشنری)

user = {"name": "Ali"}
print(user["age"])

پیام:

KeyError: 'age'
  • یعنی کلید 'age' در دیکشنری یافت نشده است.

خواندن بخش «File» و «line» و «in»

بخش وسط traceback معمولاً شبیه این است:

Traceback (most recent call last):
  File "main.py", line 10, in process_data
    result = calculate(x)
  File "main.py", line 5, in calculate
    return x / y
ZeroDivisionError: division by zero

چطور بخوانیم؟

  • ردیف ۱:
    File "main.py", line 10, in process_data
    یعنی در تابع process_data در خط ۱۰ این فایل، تابع calculate صدا زده شده.
  • ردیف ۲:
    File "main.py", line 5, in calculate
    یعنی در خود تابع calculate در خط ۵، خط مشکل‌دار وجود دارد.
  • در نهایت نوع خطا: ZeroDivisionError

نکته مهم:

  • خط واقعی خطا معمولاً در پایین‌ترین بخش لیست (آخرین File ...) است.
  • خطوط بالایی فقط «مسیر رسیدن» به آن خط را نشان می‌دهند.

برای مبتدی‌ها معمولاً:

  • به پایین‌ترین خط File نگاه کنید
  • کد همان خط را در ویرایشگر باز کنید.
  • نوع خطا + آن خط را با هم ببینید.

خواندن خطاهای حالت تعاملی (REPL / ترمینال پایتون)

اگر در حالت تعاملی (مثلاً در ترمینال پایتون) کد می‌نویسید، پیام خطا ممکن است شبیه این باشد:

>>> 10 / 0
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ZeroDivisionError: division by zero
  • File "<stdin>" یعنی این خط مستقیم در ورودی تعاملی (نه در فایل) نوشته شده است.
  • line 1 یعنی همان خطی که شما وارد کرده‌اید.

ساختار بقیه همان است.


نکات عملی برای تمرین خواندن پیام خطا

۱. پیام را *کامل* بخوانید

اشتباه رایج: فقط پایین پیام را ببینید و سریع کد را حدسی تغییر دهید.

کار درست:

  1. از بالا به پایین بخوانید.
  2. فایل و خط اصلی را پیدا کنید.
  3. نوع خطا را در نظر بگیرید.
  4. متن انگلیسی را تا حد ممکن معنی کنید (معمولاً ساده است).

۲. روی «نوع خطا» حساس باشید

وقتی چند بار این پیام‌ها را ببینید:

  • SyntaxError → احتمالاً یک چیز جا افتاده است (:، پرانتز، کوتیشن، …)
  • IndentationError → فاصله‌گذاری/تب مشکل دارد.
  • NameError → متغیر/نامی تعریف نشده است.
  • TypeError → نوع داده‌ها برای عملی که می‌خواهید، مناسب نیست.
  • ValueError → مقدار ورودی نامعتبر است.
  • IndexError / KeyError → چیزی را از لیست/دیکشنری می‌خواهید که وجود ندارد.

لازم نیست از حفظ باشید، فقط بارها با آن‌ها روبه‌رو شوید و بخوانید.

۳. استفاده از پیام خطا در جست‌وجو

اگر مشکل را نفهمیدید:

  1. متن خطای آخر را انتخاب کنید (مثلاً TypeError: unsupported operand type(s) for +: 'int' and 'str').
  2. در گوگل یا چت‌جی‌پی‌تی جست‌وجو کنید (به همراه «python»).
  3. نتیجه‌ها معمولاً مثال و توضیح دارند.

نکته: اطلاعات شخصی (مسیرهای عجیب، نام کاربر، API key و…) را در متن نگذارید.


تمرین‌های پیشنهادی (خودآزمایی)

برای تسلط روی خواندن پیام خطا، تمرین‌های زیر را انجام دهید:

  1. کد زیر را اجرا کنید و پیام خطا را خط‌به‌خط بخوانید و تفسیر کنید:
   print("شروع برنامه")
   x = 5
   y = "10"
   print(x + y)
   print("پایان برنامه")
  • نوع خطا چیست؟
  • در کدام خط؟
  • پیام چه می‌گوید؟
  1. خودتان چند خط کد عمداً اشتباه بنویسید:
    • یک if بدون :
    • یک for بدون تورفتگی
    • استفاده از متغیر اشتباه‌تایپ‌شده
    • تقسیم بر صفر

هر بار:

  • پیام خطا را بخوانید.
  • حدس بزنید مشکل کجاست.
  • بعد اصلاح کنید و دوباره اجرا کنید.
  1. وقتی در پروژه‌های بعدی این دوره با خطا روبه‌رو می‌شوید،
    همیشه قبل از هر کاری این چهار سؤال را از روی پیام خطا جواب دهید:
    • نوع خطا چیست؟
    • در کدام فایل؟
    • در کدام خط؟
    • کدام خط کد واقعاً مشکل‌دار است؟

اگر این عادت را از الان بسازید، مرحلهٔ «اشکال‌زدایی» برایتان خیلی کم‌استرس‌تر خواهد شد.

Views: 0

Comments

Please login to add a comment.

Don't have an account? Register now!

Where to Move

Move chapter:

  • ☰ 1. فصل ۱: برنامه‌نویسی چیست؟
    • ☰ 1.1. برنامهٔ کامپیوتری چیست؟
      • ☰ 1.2. پایتون چیست؟
        • ☰ 1.3. پایتون کجا استفاده می‌شود؟
          • ☰ 1.4. چگونه برنامه‌نویسی به حل مسائل کمک می‌کند
            • ☰ 1.5. اولین برنامهٔ پایتون شما
            • ☰ 2. فصل ۲: راه‌اندازی پایتون
              • ☰ 2.1. نصب پایتون (ویندوز / macOS / لینوکس)
                • ☰ 2.2. استفاده از پایتون در ترمینال
                  • ☰ 2.3. استفاده از یک IDE (IDLE / VS Code)
                    • ☰ 2.4. اجرای اسکریپت‌های پایتون
                      • ☰ 2.5. حالت تعاملی پایتون
                      • ☰ 3. فصل ۳: متغیرها و انواع داده
                        • ☰ 3.1. متغیر چیست؟
                          • ☰ 3.2. ایجاد متغیرها
                            • ☰ 3.3. اعداد (`int`، `float`)
                              • ☰ 3.4. متن (`str`)
                                • ☰ 3.5. مقادیر بولی (`True`، `False`)
                                  • ☰ 3.6. بررسی نوع داده با `type()`
                                  • ☰ 4. فصل ۴: عملیات پایه
                                    • ☰ 4.1. عملیات حسابی
                                      • ☰ 4.2. کار با اعداد
                                        • ☰ 4.3. عملیات روی رشته‌ها
                                          • ☰ 4.4. ترکیب متن و متغیرها
                                            • ☰ 4.5. کامنت‌ها در پایتون
                                            • ☰ 5. فصل ۵: ورودی و خروجی کاربر
                                              • ☰ 5.1. دریافت ورودی از کاربر
                                                • ☰ 5.2. تبدیل ورودی به عدد
                                                  • ☰ 5.3. قالب‌بندی خروجی
                                                    • ☰ 5.4. نوشتن برنامه‌های تعاملی
                                                    • ☰ 6. فصل ۶: شرط‌ها (if / else)
                                                      • ☰ 6.1. عملگرهای مقایسه‌ای
                                                        • ☰ 6.2. عملگرهای منطقی
                                                          • ☰ 6.3. if، elif، else
                                                            • ☰ 6.4. شرط‌های تو در تو
                                                              • ☰ 6.5. اشتباهات رایج مبتدیان
                                                              • ☰ 7. فصل ۷: حلقه‌ها
                                                                • ☰ 7.1. چرا حلقه‌ها مفید هستند؟
                                                                  • ☰ 7.2. حلقه‌های while
                                                                    • ☰ 7.3. حلقه‌های for
                                                                      • ☰ 7.4. شمارنده‌های حلقه
                                                                        • ☰ 7.5. break و continue
                                                                          • ☰ 7.6. تمرین‌های حلقه
                                                                          • ☰ 8. فصل ۸: مجموعه‌های داده
                                                                            • ☰ 8.1. لیست‌ها (Lists)
                                                                              • ☰ 8.2. تاپل‌ها (Tuples)
                                                                                • ☰ 8.3. دیکشنری‌ها (Dictionaries)
                                                                                  • ☰ 8.4. مجموعه‌ها (Sets – مقدماتی)
                                                                                    • ☰ 8.5. انتخاب ساختار دادهٔ مناسب
                                                                                    • ☰ 9. فصل ۹: توابع
                                                                                      • ☰ 9.1. چرا توابع مهم هستند؟
                                                                                        • ☰ 9.2. تعریف توابع
                                                                                          • ☰ 9.3. پارامترها و آرگومان‌ها
                                                                                            • ☰ 9.4. مقادیر بازگشتی
                                                                                              • ☰ 9.5. محدودهٔ متغیرها (محلی در برابر سراسری)
                                                                                                • ☰ 9.6. استفادهٔ مجدد از کد
                                                                                                • ☰ 10. فصل ۱۰: کار با فایل‌ها
                                                                                                  • ☰ 10.1. فایل چیست؟
                                                                                                    • ☰ 10.2. خواندن فایل‌های متنی
                                                                                                      • ☰ 10.3. نوشتن و افزودن به فایل‌ها
                                                                                                        • ☰ 10.4. مسیر فایل‌ها
                                                                                                          • ☰ 10.5. برنامه‌های ساده مبتنی بر فایل
                                                                                                          • ☰ 11. فصل ۱۱: خطاها و اشکال‌زدایی
                                                                                                            • ☰ 11.1. انواع خطاها
                                                                                                              • ☰ 11.2. خواندن پیام‌های خطا
                                                                                                                • ☰ 11.3. خطاهای رایج مبتدیان
                                                                                                                  • ☰ 11.4. try و except
                                                                                                                    • ☰ 11.5. راهبردهای اشکال‌زدایی
                                                                                                                    • ☰ 12. فصل ۱۲: استفاده از کتابخانه‌های پایتون
                                                                                                                      • ☰ 12.1. کتابخانه چیست؟
                                                                                                                        • ☰ 12.2. وارد کردن ماژول‌ها
                                                                                                                          • ☰ 12.3. کتابخانه‌های استاندارد
                                                                                                                            • ☰ 12.3.1. math
                                                                                                                              • ☰ 12.3.2. random
                                                                                                                                • ☰ 12.3.3. datetime
                                                                                                                                • ☰ 12.4. نصب کتابخانه‌های خارجی با pip
                                                                                                                                • ☰ 13. فصل ۱۳: برنامه‌نویسی شی‌گرا (OOP)
                                                                                                                                  • ☰ 13.1. برنامه‌نویسی شی‌گرا چیست؟
                                                                                                                                    • ☰ 13.2. کلاس‌ها و اشیاء
                                                                                                                                      • ☰ 13.3. ویژگی‌ها و متدها
                                                                                                                                        • ☰ 13.4. متد `__init__`
                                                                                                                                          • ☰ 13.5. کپسوله‌سازی
                                                                                                                                            • ☰ 13.6. وراثت (مقدماتی)
                                                                                                                                              • ☰ 13.7. مثال‌های سادهٔ شی‌گرا
                                                                                                                                              • ☰ 14. فصل ۱۴: خودکارسازی با پایتون
                                                                                                                                                • ☰ 14.1. خودکارسازی چیست؟
                                                                                                                                                  • ☰ 14.2. خودکار کردن وظایف ساده
                                                                                                                                                    • ☰ 14.3. کار با فایل‌ها و پوشه‌ها
                                                                                                                                                      • ☰ 14.4. خودکارسازی پردازش متن
                                                                                                                                                        • ☰ 14.5. زمان‌بندی اجرای اسکریپت‌ها
                                                                                                                                                          • ☰ 14.6. مثال‌های کاربردی خودکارسازی
                                                                                                                                                          • ☰ 15. فصل ۱۵: توسعهٔ وب با پایتون
                                                                                                                                                            • ☰ 15.1. وب چگونه کار می‌کند؟ (نمای کلی)
                                                                                                                                                              • ☰ 15.2. آشنایی با Flask
                                                                                                                                                                • ☰ 15.3. ساخت یک وب‌سرور ساده
                                                                                                                                                                  • ☰ 15.4. مسیرها و قالب‌ها (Templates)
                                                                                                                                                                    • ☰ 15.5. پردازش ورودی کاربر (فرم‌ها)
                                                                                                                                                                      • ☰ 15.6. API های بسیار ساده
                                                                                                                                                                      • ☰ 16. فصل ۱۶: علم داده با پایتون
                                                                                                                                                                        • ☰ 16.1. علم داده چیست؟
                                                                                                                                                                          • ☰ 16.2. کار با داده‌ها
                                                                                                                                                                            • ☰ 16.3. آشنایی با NumPy
                                                                                                                                                                              • ☰ 16.4. آشنایی با pandas
                                                                                                                                                                                • ☰ 16.5. مصورسازی داده با matplotlib
                                                                                                                                                                                  • ☰ 16.6. مثال‌های سادهٔ تحلیل داده
                                                                                                                                                                                  • ☰ 17. فصل ۱۷: پروژه‌های کوچک
                                                                                                                                                                                    • ☰ 17.1. بازی حدس عدد
                                                                                                                                                                                      • ☰ 17.2. ماشین‌حساب ساده
                                                                                                                                                                                        • ☰ 17.3. فهرست کارها (To-Do List)
                                                                                                                                                                                          • ☰ 17.4. تولیدکنندهٔ رمز عبور
                                                                                                                                                                                            • ☰ 17.5. برنامهٔ آزمون (Quiz)
                                                                                                                                                                                              • ☰ 17.6. پروژهٔ کوچک وب یا داده
                                                                                                                                                                                              • ☰ 18. فصل ۱۸: گام‌های بعدی
                                                                                                                                                                                                • ☰ 18.1. چگونه پایتون را تمرین کنیم
                                                                                                                                                                                                  • ☰ 18.2. نوشتن کد تمیز و خوانا
                                                                                                                                                                                                    • ☰ 18.3. انتخاب یک حوزهٔ تخصصی
                                                                                                                                                                                                      • ☰ 18.3.1. توسعهٔ وب
                                                                                                                                                                                                        • ☰ 18.3.2. علم داده
                                                                                                                                                                                                          • ☰ 18.3.3. خودکارسازی
                                                                                                                                                                                                            • ☰ 18.3.4. توسعهٔ نرم‌افزار
                                                                                                                                                                                                            • ☰ 18.4. منابع یادگیری و انجمن‌ها
                                                                                                                                                                                                            • ☰ 19. پیوست
                                                                                                                                                                                                              • ☰ 19.1. برگهٔ تقلب دستور زبان پایتون
                                                                                                                                                                                                                • ☰ 19.2. خطاهای رایج و راه‌حل‌ها
                                                                                                                                                                                                                  • ☰ 19.3. واژه‌نامهٔ اصطلاحات