إذا كنت تعمل باستخدام بايثون، فلا بد أنك واجهت خطأً مثل "ModuleNotFoundError: No module named 'crypto'" في وقت ما. هذا الخطأ شائعٌ خاصةً عند العمل على مشروع يتطلب تشفيرًا أو مكتباتٍ متعلقة بأمن البيانات. قد يكون هذا الخطأ مُربكًا بعض الشيء لمطوري بايثون في البداية. يبدو الكود مثاليًا، إلا أن الطرفية أو وحدة التحكم تعرض رسالة "no module named 'crypto'". يشير هذا الخطأ في الأساس إلى عدم تثبيت الحزمة المطلوبة في بيئة بايثون أو استيرادها بشكل غير صحيح. لكن لا تقلق.
في بايثون، يُمكن حل مشكلة "ModuleNotFoundError: No module named 'crypto'" بتثبيت مكتبة التشفير المناسبة، والتي عادةً ما تكون pycryptodome بدلاً من crypto. عادةً ما يكون سبب هذا الخطأ هو حزمة مفقودة أو مُسمّاة بشكل غير صحيح، ويحدث عندما يتعذر على بايثون العثور على الوحدة المطلوبة في بيئتك.
سبب هذا الالتباس هو أن اسم الحزمة المراد تثبيتها عبر pip هو pycryptodome، بينما مسار الاستيراد الصحيح هو من Crypto... شغّل pip install pycryptodome في الطرفية لإصلاح هذه المشكلة، ثم تأكد من استخدام البرنامج النصي لحالة الأحرف الصحيحة (Crypto، وليس crypto). يشرح هذا القسم إجراءات التثبيت، والمشكلات الشائعة، وكيفية التحقق من إعدادات بيئتك.
في هذه المدونة، سوف نفهم خطوة بخطوة سبب حدوث هذا الخطأ، وكيفية حله، وكيفية تجنبه في المستقبل، وكيفية الرهان المشفر أعمال. لذا، دون إضاعة وقتك، دعنا ننتقل إلى الموضوع الرئيسي.
لماذا يحدث هذا الخطأ عند العمل مع الوظائف أو المكتبات التشفيرية في بايثون؟
لتشغيل وظائف التشفير (مثل التشفير، وفك التشفير، والتجزئة، إلخ) في بايثون، نحتاج إلى مكتبات خاصة. من أشهر هذه المكتبات PyCrypto، أو نسختها المُحسّنة PyCryptodome.
تحدث هذه المشكلة عادةً عندما يتعذر على بايثون العثور على وحدة التشفير (crypto) بسبب خطأ في عبارة الاستيراد أو عدم تثبيت الوحدة. بافتراض أنها حزمة مستقلة، يحاول العديد من المطورين استخدام "استيراد التشفير" بشكل أحمق، بينما الوحدة الصحيحة هي Crypto (بحرف "C" كبير)، والتي تنشأ من مكتبة pycryptodome أو pycrypto. سيُصدر بايثون خطأ ModuleNotFoundError إذا لم تكن هذه المكتبات مثبتة في بيئتك.
يُعدّ الخلط بين مسارات الاستيراد وأسماء الحزم سببًا شائعًا آخر. يجب استيراد المكتبة من Crypto عند استخدام pip install pycryptodome لتثبيتها. استخدم Cypher import AES أو صيغة مشابهة. يصف هذا القسم الأسباب الكامنة وراء هذا الخطأ وكيفية إصلاحه بتثبيت المكتبة المناسبة وتطبيق قواعد الاستيراد الصحيحة.
عندما لا تكون هذه المكتبات مثبتة على نظامك، أو في بيئة غير مناسبة، لا يتعرف عليها مُفسّر بايثون. لهذا السبب، يُظهر لك رسالة الخطأ "لا توجد وحدة باسم 'crypto'". قد يحدث هذا الخطأ أيضًا إذا ثبّتت المكتبة ولكن استوردتها بشكل غير صحيح. على سبيل المثال، إذا كتبت "استيراد crypto" بدلاً من "استيراد Crypto"، فقد يُظهر خطأً لأن بايثون حساس لحالة الأحرف.
ما الذي يسبب الخطأ "لا يوجد وحدة باسم 'crypto'"؟
غالبًا ما يكون أحد المشاكل الرئيسية الثلاث هو سبب هذا الخطأ: إما أن عبارة الاستيراد تستخدم أحرفًا غير صحيحة، أو أن مكتبة التشفير اللازمة غير مثبتة، أو أن هناك تعارضًا بين الحزم القديمة أو المتشابهة في الأسماء. الوحدة الصحيحة هي Crypto (بحرف C كبير)، وهي أحد مكونات مكتبات pycryptodome أو pycrypto. يرتكب العديد من المطورين خطأ محاولة استيراد crypto (بحرف صغير). لن يتمكن بايثون من التعرف على الوحدة إذا لم يتم تثبيتها باستخدام pip.
البيئات المُهيأة بشكل خاطئ هي سبب شائع آخر، خاصةً عند التبديل بين إصدارات بايثون أو في البيئات الافتراضية. قد يُسبب استخدام حزم قديمة، مثل pycrypto، مشاكل في التوافق لأنها لم تعد مدعومة. يُوضح هذا الجزء الأسباب الأكثر شيوعًا لهذه المشكلة، بالإضافة إلى نصائح حول كيفية تحديد أي منها يؤثر على إعداداتك.
قد يكون لهذا الخطأ أسبابٌ عديدة. دعونا نفهم بعض الأسباب الرئيسية.
لم يتم تثبيت PyCrypto أو PyCryptodome.
إذا لم تكن هذه الحزمة موجودة على جهازك، فلن يتمكن Python من العثور عليها.
مسار التثبيت غير صحيح
أحيانًا يمتلك المطورون أكثر من إصدار واحد من بايثون (مثل بايثون 3.8 وبايثون 3.11). إذا ثبّتت الحزمة في إصدار خاطئ، فلن يتعرف عليها الكود في الإصدار الآخر، مثلًا. دوجين كريبتو.
بيان الاستيراد غير صحيح
استيراد التشفير واستيراد التشفير أمران مختلفان. حالة الأحرف مهمة جدًا في بايثون.
خطأ البيئة الافتراضية
إذا كنت تعمل في بيئة افتراضية وتم تثبيت الحزمة في البيئة العالمية، فقد يظهر هذا الخطأ.
استخدام حزمة قديمة (PyCrypto)
أصبح PyCrypto قديمًا ولا يتلقى أي تحديثات. قد يُسبب هذا مشاكل في التوافق.
ماذا يعني "ModuleNotFoundError: No module named 'crypto'"؟
تشير رسالة الخطأ هذه ببساطة إلى أن بايثون لم يعثر على وحدة باسم "crypto". هذا يعني إما أنك لم تُثبّت هذه الوحدة، أو حتى لو ثبّتها، فلن يتمكن بايثون من العثور عليها.
تعني رسالة خطأ بايثون هذه أن بايثون لا يستطيع تحديد موقع وحدة التشفير في بيئتك الحالية، على الرغم من محاولة البرنامج النصي استيرادها. يحدث هذا عادةً عندما لا يتطابق بيان الاستيراد (من Crypto…) مع اسم الحزمة، أو عندما لا يتم تثبيت الحزمة المطلوبة - عادةً pycryptodome أو pycrypto.
يحدث ارتباكٌ متكررٌ عند محاولة المستخدمين استيرادَ لغة التشفير (بالأحرف الصغيرة)، وهي غير موجودة، مع أن الوحدة الصحيحة هي Crypto (بحرف كبير "C"). علاوةً على ذلك، قد تحتوي بعض البيئات على حزم قديمة أو غير متوافقة. يصف هذا القسم الأسباب الكامنة وراء هذا الخطأ وكيفية إصلاحه باستخدام صيغة الاستيراد الصحيحة وتثبيت المكتبة المناسبة.
في كل مرة يستورد فيها بايثون وحدةً ما، يبحث عنها في مجلدها وحزم الموقع. إذا لم يكن هناك ملف أو حزمة باسم "crypto"، فسيُظهر هذا الخطأ فورًا.
ببساطة، يقول بايثون، "لم أتمكن من العثور على مكتبة باسم 'crypto'."
لماذا لم يتم العثور على وحدة التشفير؟
قد يكون هناك عدة أسباب تقنية لغياب وحدة التشفير. في كثير من الأحيان، يفترض المطورون أن "crypto" موجودة بالفعل في بايثون، لكنها ليست كذلك. هذه حزمة خارجية يجب تثبيتها بشكل منفصل. ومن المحتمل أيضًا أنك نسخت شيفرة من برنامج تعليمي أو فيديو يستخدم حزمة أقدم.
أصبحت حزم بايثون القديمة، مثل PyCrypto، قديمة. هذا يعني أن المطورين توقفوا عن تحديثها. لذلك، لا تعمل بشكل صحيح في الإصدارات الأحدث مثل بايثون 3 أو 3.11.
السيناريوهات الشائعة التي يظهر فيها هذا الخطأ
قد يحدث هذا الخطأ في مشاريع مختلفة، خاصةً عند العمل على تشفير البيانات.
على سبيل المثال، يتم استخدام مكتبة Crypto لتشغيل تشفير AES أو RSA.
- عندما تقوم بإنشاء كلمة مرور أو رمز آمن في Django أو Flask.
- عند استخدام رموز JWT في واجهة برمجة التطبيقات.
- عند تشغيل مشروع قديم في إصدار Python الجديد.
- عند تثبيت التبعيات المختلفة في بيئة افتراضية.
في كل هذه الحالات، قد يظهر هذا الخطأ فجأة. قد تواجه هذا الخطأ أيضًا أثناء مراهنات الرياضات المشفرة.
لماذا تحصل على الخطأ؟
يظهر لك هذا الخطأ لأن وحدة التشفير غير موجودة بشكل صحيح على نظامك. أحيانًا، يظهر هذا الخطأ أيضًا إذا أنشأت ملفًا باسم "crypto"، مما يؤدي إلى محاولة بايثون تحميل ملفك بدلاً من الحزمة الأصلية. يشير هذا الخطأ إلى وجود خلل في بيئة بايثون أو إعدادات التبعيات.
أين يظهر هذا الخطأ عادةً
تظهر مشكلة "ModuleNotFoundError: No module named 'crypto'" أحيانًا في مشاريع بايثون التي تتضمن معالجة بيانات آمنة، أو تطوير بلوكتشين، أو التشفير. وتنتشر هذه المشكلة بشكل خاص في البرامج النصية التي تحاول استخدام ميزات التشفير دون تثبيت المكتبات اللازمة بشكل صحيح، مثل التوقيعات الرقمية، أو أساليب التجزئة، أو تشفير AES. عند تهيئة بيئاتهم، غالبًا ما يواجه المطورون الذين يعملون على واجهات برمجة تطبيقات آمنة، أو تطبيقات ويب، أو محافظ عملات رقمية هذه المشكلة.
عند استخدام وحدات قديمة أو غير مُرجعة بشكل صحيح في البرامج التعليمية أو السياقات التعليمية أو قواعد البيانات القديمة، تحدث هذه المشكلة بشكل متكرر. سواء كنت تعمل في بيئات افتراضية أو منصات سحابية أو دفاتر Jupyter، فقد تكون هذه المشكلة ناتجة عن خطأ في تسمية مكتبات التشفير أو فقدانها.
ستشاهد هذا الخطأ غالبًا في:
- مشاريع التشفير باستخدام AES أو RSA
- تطبيقات Django/Flask التي تولد رموزًا آمنة
- واجهات برمجة التطبيقات التي تستخدم مصادقة JWT
- تم نقل المشاريع القديمة إلى إصدارات Python الأحدث
- البيئات الافتراضية ذات التبعيات المفقودة
حتى منصات المراهنة بالعملات المشفرة وتطبيقات الرياضات الإلكترونية التي تستخدم Python لإجراء معاملات آمنة قد تواجه "العملات المشفرة تؤدي إلى العملات المعدنية" أخطاء إذا لم يتم إعداد البيئة بشكل صحيح.
حلول خطوة بخطوة لمشكلة Modulenotfounderror
الآن دعونا نلقي نظرة على كيفية إصلاح هذا الخطأ خطوة بخطوة.
1. قم بتثبيت الحزمة الصحيحة
أولاً، ثبّت الحزمة الصحيحة. PyCrypto أصبح قديمًا، لذا يُنصح بتثبيت نسخته المُحسّنة، PyCryptodome.
الأمر:
Pip install pycryptodome.
بعد التثبيت، تأكد من أنه تم التثبيت بشكل صحيح:
عرض بيب بايكريبتودوم
2. استخدم عبارات الاستيراد الصحيحة
بايثون حساسة لحالة الأحرف. الطريقة الصحيحة هي:
الأمر:
من Crypto.Cipher استيراد AES
ليس
من التشفير. استيراد التشفير AES.
3. إلغاء تثبيت الحزم المتضاربة
إذا قمت بتثبيت PyCrypto وPyCryptodome، فقد يكون هناك تعارض.
الأمر:
إلغاء تثبيت Pip pycrypto
ثم قم بتثبيت PyCryptodome مرة أخرى.
4. إصلاح مشاكل البيئة الافتراضية
إذا كنت في بيئة افتراضية، قم بتنشيطها أولاً:
الأمر:
المصدر venv/bin/activate
ثم قم بتثبيت PyCryptodome في نفس البيئة.
5. تحقق من توافق إصدار Python
يعمل PyCryptodome بشكل جيد مع إصدار Python 3.6 وما فوق. إذا كان إصدار Python لديك أقدم، يُرجى تحديثه.
استكشاف الأخطاء وإصلاحها حسب نظام التشغيل
الآن دعونا نرى كيفية إصلاح هذا الخطأ على أنظمة التشغيل المختلفة.
إصلاح على ويندوز
قم بتشغيل موجه الأوامر باستخدام حقوق المسؤول.
Pip install pycryptodome
إذا استمر الخطأ، فتحقق من متغير PATH لمعرفة ما إذا كان دليل Python Scripts مدرجًا.
إصلاح على macOS
فتح المحطة.
اكتب الأمر:
python3 -m pip install pycryptodome
إذا كنت تستخدم Homebrew، فتحقق من مسار Python.
إصلاح على لينكس
أولاً، قم بتشغيل sudo apt-get update.
ثم تثبيت:
تثبيت pip3 على pycryptodome
إذا كنت تستخدم بيئة افتراضية، قم بتنشيطها أولاً.
البديل:
إذا كنت تواجه صعوبة في استخدامها، فإن مكتبة التشفير هي بديل موثوق لوحدة التشفير في بايثون. إنها حزمة شائعة وفعّالة للتشفير الآمن والتجزئة وإدارة المفاتيح. توفر Cryptography واجهة برمجة تطبيقات حديثة مبنية على OpenSSL، على عكس المكتبات القديمة أو المهجورة، مما يجعلها مناسبة للمطورين المبتدئين والخبراء على حد سواء الذين يعملون على تطبيقات آمنة.
ثبّته باستخدام pip install cryptography للبدء، ثم استخدم وحداته سهلة الاستخدام، مثل hazmat لبدائل التشفير منخفضة المستوى أو Fernet للتشفير المتماثل. يشرح هذا القسم آلية عمل مكتبة التشفير، ومزاياها مقارنةً بالبدائل القديمة، وكيفية تضمينها لتعزيز الأمان في مشاريع بايثون.
استخدم مكتبة التشفير بدلاً من ذلك
إذا لم يعمل PyCryptodome أو كنت تريد مكتبة أكثر حداثة، فيمكنك استخدام مكتبة التشفير.
نقطة تثبيت التشفير
هذه هي مكتبة التشفير الأكثر أمانًا وحداثةً في بايثون. إنها رائعة للتشفير والتوقيعات وإدارة المفاتيح. يختارها العديد من المطورين اليوم لأنها توفر واجهة برمجة تطبيقات بايثونية أكثر أمانًا. سواءً كان عالم... سلالة مزمنة مشفرة مع نمو التكنولوجيا في المستقبل، فإن القوة الحقيقية ستكمن دائمًا في الأساس الصحيح للكود.
الخاتمة
قد يبدو خطأ "ModuleNotFoundError: No module named 'crypto'" مزعجًا للوهلة الأولى، لكن حله بسيط للغاية. في معظم الحالات، يكون السبب هو التثبيت الخاطئ أو تعارضات الحزمة. إذا استخدمت الحزمة الصحيحة، وعمليات الاستيراد الصحيحة، والبيئة الصحيحة، فسيختفي هذا الخطأ فورًا. تعلمنا من خلال هذه المدونة سبب حدوث هذا الخطأ، وكيفية إصلاحه، والمكتبة الأنسب للاستخدام. هذه الأفكار التقنية البسيطة قد تنقذك من مشاكل كبيرة عند العمل باستخدام بايثون. وتذكر، كما يُحدد مؤثرو العملات المشفرة اتجاهات العالم، فإن مهمة المطور هي ضمان أمان وكفاءة الكود باستخدام الأدوات المناسبة والممارسات الصحيحة. لمزيد من المعلومات، تفضل بزيارة موقعنا الإلكتروني. 96com.
الأسئلة الشائعة حول ModuleNotFoundError
1. لماذا لم يتم العثور على "crypto" حتى بعد تثبيت pycrypto؟
لأن PyCrypto أصبح قديمًا ولا يعمل مع الإصدارات الأحدث من بايثون، ثبّت PyCryptodome بدلًا منه.
2. هل لا يزال PyCrypto مدعومًا؟
لا، لم يعد PyCrypto مدعومًا. PyCryptodome بديل أفضل وأحدث.
3. ما الفرق بين PyCrypto و PyCryptodome؟
PyCryptodome هو إصدار حديث وآمن من PyCrypto مع إصلاحات للأخطاء وإضافة ميزات جديدة.
4. هل يمكنني استخدام نفس الاستيراد مع PyCryptodome؟
نعم، يمكنك استخدام نفس الاستيرادات الموجودة في PyCrypto، فقط احتفظ باسم المكتبة "Crypto".
