KAHIBARO Bookshelves
Discord Login Register

11.1. انواع خطاها

خطا در برنامه یعنی چه؟

در فصل «خطاها و اشکال‌زدایی» به‌طور کلی با مفهوم خطا آشنا شده‌اید. در این بخش روی یک موضوع خاص تمرکز می‌کنیم: انواع خطاها در پایتون و این‌که هر کدام چه نشانه‌هایی دارند.

شناخت نوع خطا کمک می‌کند:

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

در این فصل روی سه دستهٔ اصلی تمرکز می‌کنیم:

  • خطاهای نحوی (Syntax Errors)
  • خطاهای زمان اجرا (Runtime Errors / Exceptions)
  • خطاهای منطقی (Logic Errors)

هرکدام را جداگانه می‌بینیم.


۱. خطاهای نحوی (Syntax Errors)

خطای نحوی یعنی کد شما از نظر «قانون‌های زبان پایتون» اشتباه است؛ یعنی پایتون حتی نمی‌تواند شروع به اجرای آن کند، چون «شکل» دستور غلط است.

مثال ساده:

print("سلام"

در اینجا پرانتز بسته نشده است. اگر این کد را اجرا کنید، پیامی شبیه این می‌بینید:

SyntaxError: '(' was never closed

ویژگی‌های خطای نحوی:

  • معمولاً قبل از اجرای برنامه پیدا می‌شود.
  • بیشتر مربوط به اشتباهات تایپی و فراموش‌کردن علائم است.

نمونه‌های رایج خطای نحوی:

  1. فراموش کردن دونقطه : در انتهای دستورهای کنترلی مثل if، for، while, def:
if x > 10
    print("بزرگتر از ۱۰ است")

پیام احتمالی:

SyntaxError: expected ':'
  1. استفادهٔ نادرست از پرانتز، براکت یا آکولاد
numbers = [1, 2, 3
print(numbers)

پیام احتمالی:

SyntaxError: ']' was never closed
  1. یادم رفتن کوتیشن در رشته‌ها
name = "Ali
print(name)

پیام احتمالی:

SyntaxError: unterminated string literal
  1. تایپ‌کردن کلمات کلیدی اشتباه
pritn("سلام")

اینجا در واقع pritn نه تابع است، نه کلمهٔ کلیدی؛ بعداً به‌صورت خطای دیگر (NameError) ظاهر می‌شود، اما بسیاری از IDE ها آن را هم‌ردهٔ خطاهای نحوی تشخیص می‌دهند.

چگونه خطای نحوی را تشخیص دهیم؟

  • پیام خطا با SyntaxError شروع می‌شود.
  • معمولاً خطی را نشان می‌دهد که از نظر پایتون «جایی است که اشتباه دیده».
  • گاهی خطای واقعی در خط قبل رخ داده (مثلاً جا انداختن یک پرانتز یا کوما در خط بالاتر).

۲. خطاهای زمان اجرا (Runtime Errors / Exceptions)

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

این نوع خطاها را معمولاً Runtime Error می‌گویند؛ یعنی خطایی که تنها در «زمان اجرا» معلوم می‌شود، نه در زمان نوشتن.

نمونه‌های رایج استثناها:

۲.۱. `NameError` – استفاده از متغیر ناشناخته

وقتی از نامی استفاده می‌کنید که تعریف نشده است:

print(age)

پیام:

NameError: name 'age' is not defined

رایج‌ترین علت‌ها:

  • متغیر را تعریف نکرده‌اید.
  • نام متغیر را اشتباه تایپ کرده‌اید.
  • متغیر در محدودهٔ دیگری تعریف شده و اینجا در دسترس نیست (مربوط به مبحث «محدودهٔ متغیرها»).

۲.۲. `TypeError` – نوع دادهٔ نامعتبر برای یک عمل

وقتی یک عمل را روی نوع نادرست انجام دهید:

result = "5" + 3

پیام:

TypeError: can only concatenate str (not "int") to str

یا:

len(10)

پیام:

TypeError: object of type 'int' has no len()

معنایش: این عمل برای این نوع داده مجاز نیست.

۲.۳. `ValueError` – مقدار نامعتبر با نوع صحیح

وقتی نوع ظاهراً درست است، اما «مقدار» قابل قبول نیست. مثال کلاسیک:

age = int("سلام")

پیام:

ValueError: invalid literal for int() with base 10: 'سلام'

نوع ورودی str است و تبدیل به int برای رشته‌ای که عدد نیست امکان‌پذیر نیست.

تفاوت TypeError و ValueError:

  • TypeError: نوع کلی اشتباه است (مثلاً int به جای str).
  • ValueError: نوع درست است، ولی مقدار با انتظار تابع/عمل‌گر نمی‌خواند.

۲.۴. `ZeroDivisionError` – تقسیم بر صفر

تقسیم عدد بر صفر از نظر ریاضی تعریف نشده و در پایتون خطا می‌دهد:

x = 10 / 0

پیام:

ZeroDivisionError: division by zero

۲.۵. `IndexError` – خارج شدن از محدودهٔ لیست (و سایر توالی‌ها)

وقتی به اندیس (index) عنصری دسترسی می‌خواهید که وجود ندارد:

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

پیام:

IndexError: list index out of range

۲.۶. `KeyError` – کلید ناموجود در دیکشنری

برای دیکشنری‌ها، وقتی به کلیدی دسترسی می‌خواهید که ثبت نشده:

person = {"name": "Ali", "age": 20}
print(person["city"])

پیام:

KeyError: 'city'

۲.۷. `FileNotFoundError` – فایل پیدا نشد

وقتی بخواهید فایلی را باز کنید که وجود ندارد:

f = open("file_that_does_not_exist.txt")

پیام:

FileNotFoundError: [Errno 2] No such file or directory: 'file_that_does_not_exist.txt'

۲.۸. `ImportError` / `ModuleNotFoundError` – مشکل در وارد کردن ماژول

وقتی نام ماژول را اشتباه می‌نویسید یا نصب نشده است:

import numppy

پیام:

ModuleNotFoundError: No module named 'numppy'

یا:

from math import squar

پیام:

ImportError: cannot import name 'squar' from 'math'

۳. خطاهای منطقی (Logic Errors)

در این نوع خطاها، پایتون هیچ خطایی اعلام نمی‌کند. کد شما بدون مشکل اجرا می‌شود، اما نتیجه اشتباه است. این‌ها معمولاً سخت‌ترین خطاها برای پیدا کردن هستند، چون:

  • پیامی روی صفحه ظاهر نمی‌شود.
  • فقط خروجی با «انتظار شما» تفاوت دارد.

نمونه‌ها:

۳.۱. استفاده از عمل‌گر اشتباه

می‌خواهید مجموع دو عدد را بگیرید، اما اشتباهاً ضرب می‌کنید:

x = 5
y = 3
result = x * y   # باید x + y می‌نوشتید
print(result)    # خروجی: 15، در حالی که انتظار داشتید 8

از نظر نحو و زمان اجرا هیچ ایرادی ندارد، اما «منطق برنامه» غلط است.

۳.۲. شرط اشتباه در `if`

فرض کنید می‌خواهید پیام بدهید اگر سن بزرگ‌تر یا مساوی ۱۸ بود، اما اشتباهاً از < استفاده کرده‌اید:

age = 20
if age < 18:
    print("اجازه ورود دارید")  # منطق برعکس است!

برنامه اجرا می‌شود، اما رفتارش بر خلاف نیت شماست.

۳.۳. حلقه‌ای که به تعداد اشتباه تکرار می‌شود

مثلاً می‌خواهید ۱۰ بار پیام چاپ کنید، اما به‌خاطر یک عدد اشتباه، فقط ۹ بار چاپ می‌شود:

for i in range(1, 10):  # انتظار داشتید 1 تا 10 (شامل 10)
    print(i)

خروجی ۱ تا ۹ است، نه ۱ تا ۱۰.


۴. مقایسهٔ سه نوع خطای اصلی


نوع خطاچه زمانی رخ می‌دهد؟پایتون چه می‌گوید؟مثال کوتاه
خطای نحوی (SyntaxError)قبل از شروع اجرابرنامه اصلاً اجرا نمی‌شودفراموش‌کردن : در if
خطای زمان اجرا (Exception)حین اجرای برنامهبرنامه متوقف می‌شود و پیام خطا می‌دهدتقسیم بر صفر، اندیس نامعتبر لیست
خطای منطقی (Logic Error)حین اجرا، در منطق برنامهپایتون ساکت است؛ خروجی اشتباه استاستفاده از * به‌جای +

۵. نکته‌های عملی برای کار با انواع خطا

چند نکتهٔ کوتاه برای استفاده از دانسته‌های این فصل:

  1. همیشه نوع خطا را بخوانید
    بخش اول پیام خطا (مثل SyntaxError، NameError، TypeError) سرنخ اصلی است.
  2. همیشه خطی که پیام خطا نشان می‌دهد را بررسی کنید
    اما یادتان باشد گاهی خطای واقعی در خط قبلی است (به‌ویژه در SyntaxError).
  3. برای خطاهای منطقی، به خروجی اعتماد نکنید، آن را بررسی کنید
    برای اطمینان، مقادیر میانی را با print چک کنید یا تست‌های کوچک بنویسید.
  4. الگوی خطاها را بشناسید
    بعد از مدتی، وقتی IndexError دیدید فوری به یاد می‌آورید که یک اندیس خارج از محدوده استفاده کرده‌اید. این شناخت روند اشکال‌زدایی را سریع‌تر می‌کند.

در بخش‌های بعدی این فصل، یاد می‌گیرید چطور این خطاها را بخوانید، با try و except با برخی از آن‌ها برخورد کنید، و با روش‌های اشکال‌زدایی (debugging) خطاهای منطقی را هم پیدا کنید.

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. واژه‌نامهٔ اصطلاحات