KAHIBARO Bookshelves
Discord Login Register

11.3. خطاهای رایج مبتدیان

Table of Contents

دسته‌بندی خطاهای رایج مبتدیان

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

در مثال‌ها فرض می‌کنیم قبلاً می‌دانید خطا چیست و پیام خطا را چطور به‌طور کلی می‌خوانیم؛ اینجا سراغ مصداق‌های پر‌تکرار می‌رویم.

۱. جا انداختن دو‌نقطه (:) و مشکل تورفتگی (Indentation)

۱.۱. فراموش کردن `:` بعد از ساختارهای کنترلی

در if, elif, else, for, while, def, class باید در انتهای خط، : بگذارید.

مثال اشتباه:

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

پیام معمول: SyntaxError: expected ':'

نسخهٔ درست:

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

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

۱.۲. تورفتگی‌های نامنظم

پایتون روی فاصلهٔ ابتدای خط (indentation) بسیار حساس است. قاطی‌کردن فاصله‌ها (space) و تب (tab) یا تورفتگی نامساوی باعث خطا می‌شود.

مثال اشتباه:

if x > 10:
  print("خط ۱")
    print("خط ۲")

پیام معمول: IndentationError: unexpected indent یا IndentationError: unindent does not match any outer indentation level

نکات پیشگیری:

  • از یک نوع فاصله استفاده کنید (ترجیحاً فقط space، مثلاً ۴ space برای هر سطح).
  • در ویرایشگر، گزینهٔ «نمایش فاصله و تب» را فعال کنید.
  • اگر خط کدی را کپی می‌کنید، مطمئن شوید تورفتگی‌اش با بقیه یکی است.

۲. اشتباه در نام‌ها: حروف کوچک/بزرگ و غلط‌نوشتن متغیرها

۲.۱. استفاده از نام اشتباه متغیر یا تابع

پایتون به حروف کوچک و بزرگ حساس است (case-sensitive). NameError وقتی رخ می‌دهد که پایتون متغیر/تابع را نمی‌شناسد.

مثال اشتباه:

age = 20
print(Age)

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

نسخهٔ درست:

age = 20
print(age)

یا:

userName = "Ali"
print(username)   # اشتباه در املای نام

۲.۲. تعریف‌نکردن متغیر قبل از استفاده

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

print(total)
total = 100

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

ترتیب درست:

total = 100
print(total)

۳. قاطی‌کردن `=` با `==`

  • = برای نسبت‌دادن مقدار به متغیر است.
  • == برای مقایسهٔ برابری.

مثال اشتباه (در شرط):

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

پیام: SyntaxError: invalid syntax

نسخهٔ درست:

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

برعکسش هم اتفاق می‌افتد: بعضی‌ها می‌خواهند مقدار بدهند ولی از == استفاده می‌کنند و برنامه رفتار مورد انتظار را ندارد.

x == 10  # فقط مقایسه است، مقداردهی نمی‌کند

۴. نوع دادهٔ نامناسب در عملگرها

این دستهٔ خطا معمولاً TypeError می‌دهد.

۴.1. جمع‌کردن عدد و رشته

age = 20
text = "سن شما: " + age

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

نسخهٔ درست (تبدیل به رشته):

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

یا با قالب‌بندی (که در فصل ورودی/خروجی بیشتر دیده‌اید):

age = 20
print(f"سن شما: {age}")

۴.۲. تبدیل ورودی کاربر بدون توجه به نوع

تابع input() همیشه رشته برمی‌گرداند. اگر آن را مستقیم با عدد جمع کنید:

x = input("عدد را وارد کنید: ")
result = x + 10

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

برای حل، ورودی را به عدد تبدیل کنید (اگر انتظار عدد دارید):

x = int(input("عدد را وارد کنید: "))
result = x + 10
print(result)

۵. اشتباه در استفاده از پرانتز، کروشه و آکولاد

۵.۱. پرانتز بسته‌نشده یا زیادبستن

مثال اشتباه:

print("سلام"

پیام: SyntaxError: '(' was never closed یا مشابه.

مثال اشتباه دیگر:

print(("سلام"))
)

پیام: SyntaxError: unmatched ')'

برای جلوگیری:

  • وقتی ( می‌گذارید، بلافاصله ) را هم بنویسید و وسطشان را بعداً پر کنید.
  • ویرایشگرهایی انتخاب کنید که پرانتزها را جفت‌جفت نشان می‌دهند.

۵.۲. قاطی‌کردن `()` و `[]` و `{}`

هرکدام کاربرد خودشان را دارند:

  • [] برای لیست و اندیس‌دهی
  • () برای فراخوانی تابع و گروه‌بندی
  • {} برای دیکشنری و مجموعه

مثال اشتباه:

numbers = [1, 2, 3]
print(numbers(0))   # اشتباه

پیام: TypeError: 'list' object is not callable

درست:

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

یا:

person = {"name": "Ali"}
print(person("name"))   # اشتباه

باید بنویسید:

print(person["name"])

۶. استفادهٔ اشتباه از اندیس‌ها در لیست و رشته

۶.۱. خارج از محدوده (IndexError)

مثال:

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

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

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

نسخهٔ درست:

numbers = [10, 20, 30]
print(numbers[2])   # آخرین عنصر

یا قبل از دسترسی، طول را چک کنید:

index = 3
if index < len(numbers):
    print(numbers[index])
else:
    print("چنین اندیسی وجود ندارد")

۶.۲. فرض‌گرفتن این‌که رشته/لیست خالی نیست

مثال:

text = ""
print(text[0])

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

راه حل: قبل از دسترسی، چک کنید خالی نباشد:

if text:
    print(text[0])
else:
    print("رشته خالی است")

۷. اشتباه در حلقه‌ها: حلقهٔ بی‌نهایت و شمارندهٔ اشتباه

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

مثال:

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

این حلقه هرگز تمام نمی‌شود.

درست:

x = 0
while x < 5:
    print(x)
    x = x + 1

۷.۲. تغییر دادن لیست هنگام پیمایش با `for`

مثال اشتباه:

numbers = [1, 2, 3, 4]
for n in numbers:
    if n % 2 == 0:
        numbers.remove(n)
print(numbers)

نتیجه معمولاً چیزی است که انتظار ندارید. این خطانمای منطقی است، نه لزوماً خطای اجرایی.

برای حذف امن، یا روی یک کپی حلقه بزنید:

numbers = [1, 2, 3, 4]
for n in numbers[:]:
    if n % 2 == 0:
        numbers.remove(n)

یا از روش‌های دیگر (مثل ساختن لیست جدید) استفاده کنید.

۸. اشتباه در شرط‌ها و عملگرهای منطقی

۸.۱. شرط همیشه درست یا همیشه غلط

مثال:

age = 20
if age > 18 or age < 10:
    print("شرط برقرار است")

در نگاه اول شاید معنی‌دار به‌نظر برسد، اما برای خیلی از مقادیر، شرط تقریباً همیشه درست است. اغلب از and باید استفاده شود.

اگر می‌خواستید بگویید «بزرگ‌تر از ۱۸ و کوچک‌تر از ۱۰ نیست»، باید منطق را دقیق بررسی کنید.

۸.۲. استفاده از `=` به‌جای `==` در شرط (که قبلاً گفتیم)

این هم هم‌زمان خط سینتکسی و منطقی است؛ هم اجرا نمی‌شود، هم به معنی موردنظر نیست.

۹. تکرار نام توابع و متغیرها روی نام‌های داخلی

۹.۱. بازنویسی توابع داخلی پایتون

مثال:

print = "سلام"
print("چاپ کن")

پیام: TypeError: 'str' object is not callable

چون حالا print دیگر تابع نیست، یک رشته است.

مشابه این اشتباه با list, str, sum, max و... هم رخ می‌دهد:

list = [1, 2, 3]
new_list = list("abc")  # اینجا دیگر تابع list را نداریم

راه‌حل:

  • از نام‌های عمومی داخلی برای متغیرهای خود استفاده نکنید.
  • اگر اشتباهی نام را خراب کردید، در همان نشست تعاملی می‌توانید با del پاکش کنید:
del print

(اما در اسکریپت بهتر است از اول نام مناسبی انتخاب کنید.)

۱۰. فراموش‌کردن پرانتز در فراخوانی تابع

وقتی تابع را می‌خواهید اجرا کنید، باید () را اضافه کنید؛ در غیر این صورت فقط به خود شیٔ تابع اشاره می‌کنید.

مثال:

def say_hello():
    print("سلام")
say_hello       # هیچ‌چیزی چاپ نمی‌شود

درست:

say_hello()

این اشتباه در input, print و توابع کتابخانه‌ها هم زیاد رخ می‌دهد.

۱۱. اشتباه در استفاده از `return` در توابع

۱۱.۱. چاپ به جای بازگرداندن مقدار

مثال:

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

خروجی:

  • روی صفحه: 5
  • ولی result برابر با None است (چون return نکرده‌ایم).

اگر می‌خواهید مقدار در متغیر ذخیره شود، باید return کنید:

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

۱۱.۲. فراموش‌کردن `return` در بعضی مسیرهای تابع

مثال:

def check_positive(x):
    if x > 0:
        return "مثبت است"
    # در غیر این صورت چیزی برنمی‌گرداند
print(check_positive(-5))  # None

بهتر است در همهٔ مسیرها مقدار برگردانده شود:

def check_positive(x):
    if x > 0:
        return "مثبت است"
    else:
        return "مثبت نیست"

۱۲. اشتباه در کار با فایل‌ها

۱۲.۱. فراموش‌کردن بستن فایل

گرچه در عمل خیلی وقت‌ها برنامه کوچک است و مشکلی ایجاد نمی‌کند، اما عادت بدی است.

مثال (روش ضعیف):

f = open("data.txt", "r")
content = f.read()
# فراموش کرده‌ایم f.close() را صدا بزنیم

روش استاندارد (با with — توضیح کاملش در فصل فایل‌ها):

with open("data.txt", "r") as f:
    content = f.read()

۱۲.۲. بازکردن فایل در حالت اشتباه

مثال:

f = open("data.txt", "r")
f.write("سلام")

پیام: io.UnsupportedOperation: not writable

برای نوشتن باید حالت را w یا a بگذارید:

with open("data.txt", "w") as f:
    f.write("سلام")

۱۳. بدفهمی پیام خطا و نادیده‌گرفتن خط آخر

یک خطای تکراری مبتدیان این است که:

  • فقط به اولین خط پیام خطا نگاه می‌کنند،
  • یا کل متن را نادیده می‌گیرند و فقط «کار نمی‌کند» می‌گویند.

نکته‌های عملی:

  1. همیشه خط آخر پیام خطا را بخوانید؛ آنجا نوع خطا و جملهٔ توضیحی کوتاه نوشته شده.
  2. خط قبل از آن معمولاً شمارهٔ خط و نام فایل را نشان می‌دهد؛ همان‌جا را بررسی کنید.
  3. اگر از اینترنت کمک می‌گیرید، متن کامل خطا را (بدون اطلاعات شخصی) جست‌وجو کنید.

مثال پیام خطا:

Traceback (most recent call last):
  File "test.py", line 3, in <module>
    print(x)
NameError: name 'x' is not defined

برای تمرین، سعی کنید:

  • نوع خطا را بگویید (NameError),
  • در کدام فایل (test.py),
  • در کدام خط (line 3),
  • دلیل کوتاه (name 'x' is not defined).

۱۴. راهبردهای ساده برای جلوگیری از خطاهای رایج

در کنار فصل «راهبردهای اشکال‌زدایی»، چند توصیه مخصوصِ همین خطاهای مبتدیانه:

  1. کد را تکه‌تکه بنویسید و اجرا کنید
    به‌جای نوشتن ۵۰ خط و بعد اجرا، هر ۳–۵ خط یک بار برنامه را اجرا کنید.
  2. از چاپ (print) برای فهمیدن وضعیت استفاده کنید
    وقتی نتیجه عجیب است، در بخش‌های مهم مقدار متغیرها را چاپ کنید.
  3. به پیام‌های خطا احترام بگذارید
    قبل از هر کاری، آرام پیام را بخوانید و کلمه‌های کلیدی‌اش را ترجمه یا جست‌وجو کنید.
  4. نام متغیرها و توابع را معنی‌دار انتخاب کنید
    این کار هم جلوی NameError می‌گیرد، هم خوانایی را بالا می‌برد.
  5. از ویرایشگر مناسب استفاده کنید
    ویرایشگری که:
    • تورفتگی را نشان دهد،
    • پرانتزها را جفت کند،
    • کلمات کلیدی را رنگی کند،
      کمک زیادی برای جلوگیری از خطاهای نحوی می‌کند.

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

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