رفع خطای ModuleNotFoundError: no module named در پایتون

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

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

دلایل رایج بروز خطای ModuleNotFoundError

چند دلیل اصلی برای بروز این خطا وجود دارد:

نصب نبودن ماژول مورد نظر: اصلی‌ترین دلیل این خطا، نصب نبودن کتابخانه‌ای است که قصد استفاده از آن را دارید.

اشتباه در نوشتن نام ماژول: گاهی اوقات نام ماژول به‌اشتباه تایپ می‌شود (مثلاً استفاده از _ به‌جای - یا بالعکس).

استفاده از محیط اشتباه (Virtual Environment): اگر از محیط‌های مجازی استفاده می‌کنید و کتابخانه مورد نظر در محیط دیگری نصب شده، این خطا نمایش داده می‌شود.

تفاوت نسخه‌های پایتون: ممکن است کتابخانه را با pip برای نسخه‌ای از پایتون نصب کرده باشید، اما پروژه شما با نسخه دیگری اجرا شود.

روش رفع خطای ModuleNotFoundError در پایتون

برای رفع این خطا روش های مختلفی وجود دارد که برای یادگیری آنها میتوانید این ویدیو را مشاهده کنید