KAHIBARO Bookshelves
Discord Login Register

11. فصل ۱۱: خطاها و اشکال‌زدایی

چرا این فصل مهم است؟

هیچ برنامه‌نویسی (حتی حرفه‌ای‌ها) بدون خطا کد نمی‌نویسد. تفاوت یک مبتدی و یک برنامه‌نویس خوب در این نیست که «خطا نکند»، بلکه در این است که بلد باشد خطا را پیدا و برطرف کند. این فصل به شما کمک می‌کند:

  • انواع خطاها را بشناسید
  • پیام‌های خطا را بخوانید و معنی‌شان را بفهمید
  • از try و except برای مدیریت خطاها استفاده کنید
  • روش‌هایی برای اشکال‌زدایی (debugging) یاد بگیرید

در این فصل تمرکز روی ایده‌ها و مهارت‌های عمومی است؛ جزئیات فنی هر زیرموضوع در زیربخش‌های خودش (انواع خطاها، try/except و …) باز می‌شود.

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

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

  • برنامه را در همان نقطه متوقف می‌کند
  • یک پیام خطا روی صفحه نمایش می‌دهد

هدف ما در این فصل این است که:

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

به مجموع این کارها می‌گوییم اشکال‌زدایی (Debugging).

تفاوت خطا و باگ

در گفتگوهای روزمره، «خطا» و «باگ» گاهی به یک معنا استفاده می‌شوند، اما بهتر است یک تفکیک ساده داشته باشیم:

  • خطا (Error)
    • چیزی است که پایتون رسماً به شما گزارش می‌کند
    • معمولاً با یک پیام خطا همراه است
    • باعث توقف اجرا می‌شود (مگر اینکه مدیریت شود)
  • باگ (Bug)
    • یعنی برنامهٔ شما رفتار اشتباه، غیرمنتظره یا نامطلوب دارد
    • ممکن است هیچ پیام خطایی ندهد
    • تشخیصش معمولاً سخت‌تر است، چون از نظر پایتون همه‌چیز «مجاز» است، ولی از نظر منطق مسئله غلط است

مثال باگ بدون پیام خطا:

price = 100
discount = 10   # درصد
final_price = price + price * discount / 100  # اینجا در واقع داریم تخفیف را اضافه می‌کنیم!
print(final_price)

این کد از نظر پایتون کاملاً درست است و خطایی نمی‌دهد، اما منطقش اشتباه است؛ باید از - استفاده می‌کردیم، نه +. این یک باگ منطقی است.

خطاها از کجا می‌آیند؟

چند منبع رایج:

  • اشتباه در تایپ دستورها
    • نام تابع یا متغیر را اشتباه می‌نویسید
    • پرانتز، کوتیشن، دو نقطه و … را فراموش می‌کنید
  • اشتباه در نوع داده‌ها
    • سعی می‌کنید یک رشته را با عدد جمع کنید
    • رشته‌ای که قرار است عدد باشد، در واقع متن نامعتبر است
  • اشتباه در منطق برنامه
    • شرط‌ها (if…) اشتباه نوشته شده‌اند
    • حلقه‌ها (for، while) درست خاتمه داده نشده‌اند
    • فرمول‌های ریاضی را اشتباه پیاده کرده‌اید
  • وابستگی به چیزهای بیرون از برنامه
    • فایل وجود ندارد یا مسیرش اشتباه است
    • اینترنت قطع است
    • ورودی کاربر آن‌طور که انتظار داشتید نیست

در فصل‌های بعدی، بسیاری از این منابع خطا را در زمینه‌های خاص (فایل‌ها، وب، علم داده و …) خواهید دید؛ این فصل روی اصول کلی تمرکز دارد.

پیام‌های خطا در پایتون چه شکلی‌اند؟

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

Traceback (most recent call last):
  File "test.py", line 2, in <module>
    print(1 / 0)
ZeroDivisionError: division by zero

چیزهایی که باید یاد بگیرید از درون این متن پیدا کنید:

  • نام فایل (test.py)
  • شمارهٔ خط (line 2)
  • بخشی از کدی که مشکل دارد (print(1 / 0))
  • نوع خطا (ZeroDivisionError)
  • توضیح کوتاه خطا (division by zero)

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

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

روند کلی اشکال‌زدایی

برای برطرف کردن یک خطا یا باگ، معمولاً یک روند تکراری را طی می‌کنیم:

  1. مشکل را مشاهده کنید
    • پیام خطا را بخوانید
    • یا خروجی اشتباه/رفتار عجیب را ببینید
  2. محل تقریبی مشکل را پیدا کنید
    • از شمارهٔ خط در پیام خطا استفاده کنید
    • یا قطعه کدی که نتیجهٔ اشتباه می‌دهد را محدود کنید
  3. دلیل احتمالی را حدس بزنید
    • نوع خطا را ببینید (مثلاً TypeError، NameError و …)
    • ورودی‌ها، نوع داده‌ها و منطق خودتان را بررسی کنید
  4. کد را کمی تغییر دهید
    • پرینت بگذارید (print) تا بفهمید متغیرها چه مقداری دارند
    • بخشی از کد را موقتاً کامنت کنید
    • یا از try/except استفاده کنید تا اطلاعات بیشتری بگیرید
  5. دوباره اجرا کنید و نتیجه را ببینید
    • اگر درست شد، تغییر را تثبیت کنید
    • اگر هنوز مشکل هست، حدس‌تان را اصلاح کنید و دوباره تلاش کنید

این یک فرآیند مرحله‌به‌مرحله است، نه یک کار یک‌باره.

فرق «مدیریت خطا» و «رفع خطا»

دو کار متفاوت ولی مرتبط:

  • رفع خطا (Fixing)
    • یعنی کدی بنویسید که اصلاً خطا رخ ندهد
    • مثلاً قبل از تقسیم، بررسی کنید که مخرج صفر نباشد
  • مدیریت خطا (Handling)
    • یعنی اگر هم خطا رخ داد، برنامه مودبانه و کنترل‌شده رفتار کند
    • از try/except استفاده می‌کنیم
    • به کاربر پیام مناسب نشان می‌دهیم، یا راه جایگزین اجرا می‌کنیم، یا فقط خطا را ثبت می‌کنیم

در این فصل، هر دو را خواهید دید؛ اما فصل «try و except» به طور خاص روی مدیریت خطا تمرکز می‌کند.

اشکال‌زدایی با چاپ کردن (`print`)

یکی از ساده‌ترین و مؤثرترین روش‌های اشکال‌زدایی برای مبتدی‌ها استفاده از print است. ایدهٔ ساده است:

  • قبل و بعد از بخش‌های مهم کد، مقادیر متغیرها را چاپ کنید
  • ببینید آیا مقدارها همان چیزی هستند که انتظار داشتید یا نه

مثلاً اگر حلقه‌تان درست کار نمی‌کند:

total = 0
for i in range(5):
    print("قبل از جمع، i =", i, "total =", total)
    total = total + i
    print("بعد از جمع، i =", i, "total =", total)
print("نتیجهٔ نهایی:", total)

این نوع پرینت‌ها شاید در نسخهٔ نهایی برنامه نمانند، اما در طول اشکال‌زدایی ابزار اصلی شما هستند.

عادت‌های خوب برای کاهش خطا

اشکال‌زدایی راحت‌تر می‌شود اگر از ابتدا چند عادت را رعایت کنید:

  • کد را کم‌کم بنویسید و زودبه‌زود اجرا کنید
    • به‌جای اینکه ۵۰ خط کد بنویسید و بعد اجرا کنید، هر ۵–۱۰ خط یک‌بار اجرا کنید
    • اگر خطایی پیش آمد، می‌دانید در همین بخش تازه‌نوشته شده است
  • کد را تمیز و خوانا بنویسید
    • اسم‌های معنی‌دار برای متغیرها
    • تورفتگی (indentation) منظم
    • استفاده از کامنت‌های کوتاه در جاهای پیچیده
    • این کارها در فصل «کد تمیز» بیشتر بررسی می‌شود، ولی همین‌جا هم کمک می‌کند بدانید کجا را باید نگاه کنید
  • قبل از اجرا، کد را با صدای بلند برای خودتان بخوانید
    • خط‌به‌خط تصور کنید کامپیوتر چه کاری انجام می‌دهد
    • خیلی وقت‌ها خودتان قبل از اجرا متوجه اشتباه می‌شوید
  • نمونهٔ ورودی‌های مختلف را امتحان کنید
    • فقط «حالت ایده‌آل» را تست نکنید
    • ورودی‌های عجیب، خالی، صفر، منفی و … را هم چک کنید

برخورد درست با پیام‌های خطا

وقتی اولین‌بار با پیام‌های خطا روبه‌رو می‌شوید، ممکن است طولانی و ترسناک به‌نظر برسند. اما:

  • اغلب دو–سه خط آخر مهم‌ترین بخش هستند (نوع خطا و توضیح کوتاه)
  • با تمرین، به‌تدریج چشم‌تان به آن‌ها عادت می‌کند
  • به‌جای ترسیدن یا بستن پنجره، سعی کنید مثل یک «معما» به آن نگاه کنید:
    • چه نوع خطایی است؟
    • در کدام فایل و کدام خط؟
    • کدام دستور مشکل‌ساز شده است؟

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

نقش IDE و ابزارها در اشکال‌زدایی

در فصل‌های مربوط به IDE و ابزارها اشاره شده که محیطی مثل VS Code امکاناتی مثل:

  • برجسته کردن خطای نحوی (Syntax) قبل از اجرا
  • نمایش شمارهٔ خط
  • گاهی پیشنهاد خودکار کد

را دارد. در زمینهٔ اشکال‌زدایی:

  • پیدا کردن خط‌هایی که مشکل دارند سریع‌تر می‌شود
  • می‌توانید از «نقاط توقف» (breakpoints) و «اجرای قدم‌به‌قدم» استفاده کنید (در بخش استراتژی‌های اشکال‌زدایی بیشتر گفته می‌شود)

اما حتی در ساده‌ترین حالت (ترمینال + ویرایشگر معمولی)، اصولی که در این فصل می‌آموزید کاملاً کاربرد دارند.

خلاصهٔ فصل

در این فصل با چند ایدهٔ اساسی آشنا شدید:

  • خطا یعنی برنامه متوقف می‌شود و پیام خطا می‌دهد؛
  • باگ یعنی رفتار غلط، حتی اگر پیامی هم نباشد؛
  • پیام‌های خطا راهنمای شما هستند، نه دشمن شما؛
  • اشکال‌زدایی یک روند مرحله‌به‌مرحله است: مشاهده → حدس → آزمایش → تکرار؛
  • استفاده از print، نوشتن تدریجی کد و عادت‌های خوب نوشتن، اشکال‌زدایی را بسیار آسان‌تر می‌کند؛
  • در زیربخش‌های بعدی، انواع خطا، خواندن پیام‌ها، try/except و روش‌های حرفه‌ای‌تر اشکال‌زدایی را می‌بینید.

در ادامه، ابتدا به طور مشخص به انواع خطاها در پایتون می‌پردازیم.

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