KAHIBARO Bookshelves
Discord Login Register

19.2. خطاهای رایج و راه‌حل‌ها

Table of Contents

فهرست کلی خطاهای رایج

در این پیوست، روی خطاهایی تمرکز می‌کنیم که تقریبا همهٔ مبتدی‌ها در پایتون با آن‌ها برخورد می‌کنند و برای هرکدام، نمونه‌کد و راه‌حل پیشنهاد می‌کنیم. توضیح مفصل انواع خطا و try/except قبلا در فصل «خطاها و اشکال‌زدایی» آمده؛ این‌جا بیشتر شبیه یک برگهٔ تقلب برای «اوه باز هم این خطا!» است.

در این فصل این دسته خطاها را می‌بینید:

  • خطاهای نحوی (Syntax)
  • خطاهای مربوط به نام و نوع (NameError، TypeError، ValueError، …)
  • خطاهای ایندکس و کلید (IndexError، KeyError)
  • خطاهای تقسیم و اعداد (ZeroDivisionError)
  • خطاهای معمول در ورودی/خروجی و فایل‌ها
  • خطاهای رایج در شرط‌ها و حلقه‌ها
  • خطاهای رایج در توابع
  • چند توصیهٔ کوتاه برای پیدا کردن و رفع سریع خطا

در هر بخش، الگوی «پیام خطا → چرا رخ داده → چگونه درستش کنیم» را دنبال می‌کنیم.


۱. خطاهای نحوی (SyntaxError و IndentationError)

۱.۱ فراموش‌کردن دونقطه `:`

خیلی رایج در if, for, while, def, class و غیره.

if x > 10
    print("بزرگ‌تر از ۱۰")

پیام معمول: SyntaxError: invalid syntax

راه‌حل: در انتهای خط دستورهای بلوکی، : بگذارید:

if x > 10:
    print("بزرگ‌تر از ۱۰")

همین اشتباه در for, while, def, elif, else, try, except, class هم تکرار می‌شود.


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

یکی از شایع‌ترین خطاها:

if x > 10:
print("بزرگ‌تر از ۱۰")

پیام‌ها:

  • IndentationError: expected an indented block
  • یا IndentationError: unexpected indent

نکات و راه‌حل:

  • بعد از : باید کد تو‌رفته (indent شده) باشد.
  • در یک فایل، یا فقط از اسپیس استفاده کنید یا فقط از تب؛ قاطی‌کردن‌شان مشکل می‌سازد.
  • در اکثر IDEها می‌توانید تنظیم کنید که تب به ۴ اسپیس تبدیل شود.

نسخهٔ درست:

if x > 10:
    print("بزرگ‌تر از ۱۰")

۱.۳ پرانتز، براکت، یا کوتیشن بسته‌نشده

پرانتز یا براکت ناقص

numbers = [1, 2, 3, 4
print(numbers)

پیام معمول: SyntaxError: '[' was never closed یا شبیه آن.

راه‌حل: جفت (), [], {} را کامل بررسی کنید:

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

رشتهٔ بسته‌نشده

text = "سلام دنیا
print(text)

راه‌حل: کوتیشن شروع و پایان هر رشته را چک کنید:

text = "سلام دنیا"
print(text)

۱.۴ استفادهٔ اشتباه از `=` و `==`

در شرط‌ها، گاهی به‌جای == از = استفاده می‌شود:

if x = 5:
    print("x پنج است")

پیام: SyntaxError: invalid syntax

راه‌حل: در شرط‌ها برای مقایسه از == استفاده کنید:

if x == 5:
    print("x پنج است")

= فقط برای نسبت‌دادن مقدار به متغیر است.


۲. NameError – استفاده از متغیر تعریف‌نشده

پیام: NameError: name 'x' is not defined

نمونه:

print(total)
total = 10

یا اشتباه تایپی:

total = 10
print(totla)

چرا رخ می‌دهد؟

  • از متغیری استفاده کرده‌اید که هنوز تعریف نشده.
  • نام را اشتباه نوشته‌اید.
  • متغیر داخل تابع محلی بوده و بیرون تابع به آن دسترسی ندارید (محدودهٔ متغیرها).

راه‌حل‌ها:

  • ترتیب خطوط را چک کنید؛ اول تعریف، بعد استفاده:
  total = 10
  print(total)
  • املای نام را با دقت بررسی کنید.
  • اگر تابع دارید، مطمئن شوید متغیری که بیرون از تابع می‌خواهید، یا return شده یا به شکل درستی سراسری است (برای جزئیات به فصل توابع و محدودهٔ متغیرها مراجعه کنید).

۳. TypeError – نوع داده نامناسب

۳.۱ جمع‌کردن عدد با رشته

پیام پایه: TypeError: can only concatenate str (not "int") to str

نمونه:

age = 20
print("سن شما: " + age)

چرا؟ در پایتون نمی‌توانید مستقیم str و int را با + کنار هم بگذارید.

راه‌حل‌ها:

  • تبدیل عدد به رشته:
  age = 20
  print("سن شما: " + str(age))
  • یا استفاده از f-string:
  age = 20
  print(f"سن شما: {age}")

۳.۲ فراخوانی چیزی که قابل فراخوانی نیست

پیام: TypeError: 'int' object is not callable یا مشابه.

نمونهٔ رایج:

x = 5
x()

یا:

list = [1, 2, 3]
list()

چرا؟ فقط توابع (و بعضی اشیاء خاص) قابل «فراخوانی» با () هستند. int، list (شیء لیست، نه کلاس list) و … تابع نیستند.

راه‌حل:

  • از () فقط برای تابع‌ها استفاده کنید.
  • نام متغیرها را طوری انتخاب نکنید که با نام توابع داخلی تداخل داشته باشند:
  numbers = [1, 2, 3]     # بهتر از استفاده از نام list
  print(len(numbers))

۴. ValueError – مقدار نامعتبر

رایج‌ترین نمونه در تبدیل ورودی:

age = int(input("سن را وارد کنید: "))

اگر کاربر وارد کند: بیست → پیام:

ValueError: invalid literal for int() with base 10: 'بیست'

راه‌حل‌های ساده:

  • به کاربر توضیح بدهید که باید عدد وارد کند.
  • قبل از تبدیل، ورودی را بررسی کنید (جزئیات بیشتر در فصل ورودی/خروجی و خطاها).

نمونهٔ کنترل خیلی ساده:

text = input("یک عدد وارد کنید: ")
if text.isdigit():
    number = int(text)
    print("عدد شما:", number)
else:
    print("لطفاً فقط رقم وارد کنید.")

۵. IndexError و KeyError

۵.۱ IndexError – دسترسی خارج از محدودهٔ لیست

پیام: IndexError: list index out of range

نمونه:

numbers = [10, 20, 30]
print(numbers[3])

لیست ۳ عنصر دارد؛ اندیس معتبر: 0, 1, 2. اندیس 3 وجود ندارد.

راه‌حل‌ها:

  • قبل از دسترسی، طول لیست را چک کنید:
  idx = 3
  if idx < len(numbers):
      print(numbers[idx])
  else:
      print("اندیس نامعتبر است")
  • در حلقه‌ها، از for item in list یا for i in range(len(list)) استفاده کنید.

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

پیام: KeyError: 'age'

نمونه:

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

راه‌حل‌های رایج:

  • اول چک کنید کلید وجود دارد:
  if "age" in person:
      print(person["age"])
  else:
      print("سن تعریف نشده است.")
  • یا از get با مقدار پیش‌فرض:
  age = person.get("age", "نامشخص")
  print(age)

۶. ZeroDivisionError – تقسیم بر صفر

پیام: ZeroDivisionError: division by zero

نمونه:

x = 10
y = 0
print(x / y)

راه‌حل‌های معمول:

  • قبل از تقسیم، مخرج را بررسی کنید:
  if y != 0:
      print(x / y)
  else:
      print("نمی‌توان بر صفر تقسیم کرد.")
  • در برنامه‌های واقعی، ممکن است از try/except برای مدیریت این حالت استفاده کنید.

۷. خطاهای رایج در ورودی/خروجی و فایل‌ها

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

پیام: FileNotFoundError: [Errno 2] No such file or directory: 'data.txt'

نمونه:

f = open("data.txt", "r")
content = f.read()
f.close()

دلایل معمول:

  • نام فایل یا پسوند را اشتباه نوشته‌اید (data.txt درحالی‌که فایل data.csv است).
  • مسیر فایل اشتباه است؛ فایل در پوشهٔ دیگری است.
  • اسکریپت را از مکانی دیگر اجرا می‌کنید و مسیر نسبی تغییر کرده.

راه‌حل‌ها:

  • نام و مسیر فایل را دقیق چک کنید.
  • مطمئن شوید فایل در همان پوشه‌ای است که اسکریپت را اجرا می‌کنید یا از مسیر کامل (absolute path) استفاده کنید.
  • از with استفاده کنید (برای مدیریت فایل‌ها در فصل مربوط توضیح داده شده):
  with open("data.txt", "r", encoding="utf-8") as f:
      content = f.read()

۷.۲ PermissionError – مجوز ندارید

پیام: PermissionError: [Errno 13] Permission denied: 'file.txt'

نمونه‌های رایج:

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

راه‌حل:

  • مطمئن شوید در حالت مناسب باز می‌کنید ("w", "a", "r").
  • در سیستم‌عامل، مجوزهای فایل/پوشه را بررسی کنید.
  • اگر نیاز به نوشتن دارید، جای مناسب‌تری برای ذخیره انتخاب کنید (مثلا پوشهٔ کاربر).

۸. خطاهای رایج در شرط‌ها و حلقه‌ها

۸.۱ حلقهٔ بی‌نهایت ناخواسته

حلقه‌ای که هیچ‌وقت تمام نمی‌شود:

x = 0
while x < 5:
    print(x)
    # فراموش کردیم x را تغییر دهیم

برنامه تا ابد 0 چاپ می‌کند.

راه‌حل:

  • مطمئن شوید متغیر شرط داخل حلقه تغییر می‌کند:
  x = 0
  while x < 5:
      print(x)
      x += 1
  • اگر برنامه گیر کرده است، معمولا می‌توانید با Ctrl + C در ترمینال آن را متوقف کنید.

۸.۲ اشتباه در مقایسهٔ رشته‌ها و حروف کوچک/بزرگ

نمونه:

answer = input("بله یا خیر؟ ")
if answer == "بله":
    print("قبول شد")

اگر کاربر بله را با فاصله یا با حروف مختلف بنویسد، شرط برقرار نمی‌شود.

راه‌حل‌های ساده:

  • حذف فاصلهٔ اضافی و یکسان‌سازی حروف:
  answer = input("بله یا خیر؟ ").strip().lower()
  if answer == "بله":
      print("قبول شد")
  • یا چند حالت مختلف را بررسی کنید.

۸.۳ استفادهٔ نادرست از عملگرهای منطقی

اشتباه رایج:

x = 5
if x == 1 or 2 or 3:
    print("x در بین ۱، ۲، ۳ است")

این کد تقریبا همیشه True است و اشتباه است.

راه‌حل‌های درست:

  • استفاده از in:
  if x in [1, 2, 3]:
      print("x در بین ۱، ۲، ۳ است")
  • یا نوشتن کامل شرط‌ها (کم‌خواناتر):
  if x == 1 or x == 2 or x == 3:
      print("x در بین ۱، ۲، ۳ است")

۹. خطاهای رایج در توابع

۹.۱ فراموش‌کردن `return`

نمونه:

def add(a, b):
    c = a + b   # فراموش کردیم return کنیم
result = add(2, 3)
print(result)

خروجی: None

چرا؟ وقتی تابع return نداشته باشد، به‌طور پیش‌فرض None برمی‌گرداند.

راه‌حل:

def add(a, b):
    c = a + b
    return c
result = add(2, 3)
print(result)

۹.۲ تعداد آرگومان‌های اشتباه

پیام‌ها:

  • TypeError: my_func() missing 1 required positional argument: 'x'
  • TypeError: my_func() takes 2 positional arguments but 3 were given

نمونه:

def greet(name):
    print("سلام", name)
greet()          # آرگومان ندادیم
greet("علی", 2)  # آرگومان اضافی دادیم

راه‌حل‌ها:

  • تعریف تابع را چک کنید و به همان تعداد پارامتر، آرگومان بدهید.
  • اگر بعضی پارامترها اختیاری‌اند، می‌توانید مقدار پیش‌فرض بگذارید (جزئیات در فصل توابع):
  def greet(name="دوست"):
      print("سلام", name)
  greet()
  greet("علی")

۱۰. چند نکته برای پیدا کردن و رفع سریع خطاها

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

  1. از پیام خطا نترسید. متن خطا را تا آخر بخوانید؛ نوع خطا (TypeError, NameError, …) معمولا مستقیما می‌گوید مشکل چه جنسی دارد.
  2. به شمارهٔ خط دقت کنید. در پیام خطا معمولا نوشته می‌شود خط چندم مشکل داشته؛ از همان‌جا شروع کنید.
  3. به چند خط قبل و بعد نگاه کنید. گاهی خطا در خط بعدی ظاهر می‌شود ولی ریشه در خط قبل دارد (مثلا پرانتز بسته‌نشده).
  4. چاپ مقادیر (print) را فراموش نکنید. اگر نمی‌دانید یک متغیر چه مقداری دارد، آن را چاپ کنید تا مطمئن شوید آن‌چه فکر می‌کنید هست یا نه.
  5. کد را کوچک کنید. اگر برنامهٔ شما بزرگ است، بخشی که خطا می‌دهد را جدا کنید و در یک اسکریپت کوچک تست کنید. پیدا کردن خطا در کد کوچک آسان‌تر است.
  6. از IDE یا ویرایشگر خوب استفاده کنید. بسیاری از خطاهای نحوی (مثل فراموش‌کردن : یا پرانتز) قبل از اجرا با رنگ یا علامت نشان داده می‌شوند.
  7. برای خطاهای تکراری، الگو بشناسید. مثلا اگر چند بار TypeError گرفته‌اید که می‌گوید int و str نمی‌شود با هم جمع شوند، بدانید هرجا + بین عدد و متن گذاشته‌اید ممکن است همین خطا را ببینید.

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

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