شرح pip في Python: تثبيت مكتبات بايثون وإدارة الحزم للمبتدئين

{getToc} $title={محتوى المقال}

إذا بدأت تعلم بايثون ووجدت في أحد الشروحات أمرًا مثل pip install requests أو pip install pandas فقد تتساءل: ما هو pip؟ ولماذا نحتاجه؟ وهل هو جزء من لغة بايثون أم برنامج منفصل؟

في هذا الدرس من بايثون العرب سنشرح pip في Python بطريقة مبسطة للمبتدئين، مع توضيح طريقة تثبيت مكتبات بايثون، تحديثها، حذفها، عرض المكتبات المثبتة، استخدام ملف requirements.txt، وأهم الأخطاء التي قد تواجهك أثناء استخدام pip.

الفكرة ببساطة: لغة بايثون تأتي مع أدوات أساسية، لكن عندما تحتاج مكتبات إضافية مثل requests أو flask أو pandas، غالبًا ستستخدم pip لتثبيتها وإدارتها. {alertInfo}

ما هو pip في Python؟

كلمة pip تشير إلى أداة تُستخدم لتثبيت وإدارة مكتبات بايثون الخارجية. عندما تريد إضافة مكتبة غير موجودة افتراضيًا في بايثون، يمكنك غالبًا تثبيتها من خلال أمر بسيط في موجه الأوامر أو Terminal.

مثال:

python -m pip install requests

هذا الأمر يطلب من Python تشغيل أداة pip لتثبيت مكتبة اسمها requests. وبعد التثبيت يمكنك استخدامها داخل كود بايثون بهذا الشكل:

import requests

وهنا يجب الانتباه إلى نقطة مهمة جدًا: pip يُستخدم في Terminal أو موجه الأوامر، وليس داخل ملف بايثون مباشرة. أما import فتُستخدم داخل كود Python لاستدعاء المكتبة بعد تثبيتها.

ما الفرق بين pip و import؟

الأمر	أين يُستخدم؟	وظيفته	مثال
pip install	في Terminal أو CMD	تثبيت مكتبة على جهازك أو داخل البيئة الافتراضية	pip install requests
import	داخل ملف Python	استدعاء المكتبة لاستخدامها في الكود	import requests

قاعدة مهمة: إذا لم تكن المكتبة مثبتة، فلن يكفي كتابة import داخل الكود. يجب تثبيتها أولًا باستخدام pip. {alertWarning}

كيف تتأكد أن pip مثبت على جهازك؟

قبل تثبيت أي مكتبة، جرّب معرفة إصدار pip الموجود عندك. افتح موجه الأوامر في Windows أو Terminal في Linux/macOS واكتب:

python -m pip --version

وقد يعمل معك أيضًا:

pip --version

إذا ظهر لك رقم إصدار مثل:

pip 24.0 from ...

فهذا يعني أن pip موجود ويعمل.

أما إذا ظهرت لك رسالة مثل pip is not recognized أو No module named pip فالمشكلة غالبًا في تثبيت Python أو في إعداد PATH أو في أن pip غير مثبت في البيئة التي تستخدمها.

لماذا نستخدم python -m pip بدل pip مباشرة؟

قد تلاحظ أن بعض الشروحات تكتب:

pip install requests

بينما شروحات أخرى تكتب:

python -m pip install requests

الأفضل للمبتدئ غالبًا استخدام الصيغة الثانية، لأنها تجعل Python نفسه يشغّل pip المرتبط بنفس نسخة بايثون التي تعمل عليها. هذا يقلل مشاكل تثبيت المكتبة في نسخة Python مختلفة عن النسخة التي تستخدمها في مشروعك.

نصيحة للمبتدئين: عندما تواجه مشكلة أن المكتبة مثبتة ولكن Python لا يجدها، جرّب استخدام python -m pip بدل pip فقط. {alertSuccess}

تثبيت مكتبة في Python باستخدام pip

لنفترض أنك تريد تثبيت مكتبة requests، وهي مكتبة مشهورة للتعامل مع طلبات الويب. استخدم الأمر التالي:

python -m pip install requests

بعد انتهاء التثبيت، جرّب استخدامها في ملف Python:

import requests

response = requests.get("https://example.com")
print(response.status_code)

إذا لم تظهر رسالة خطأ، فهذا يعني أن المكتبة تم تثبيتها بنجاح.

تثبيت إصدار محدد من مكتبة

أحيانًا تحتاج إلى تثبيت إصدار معين من مكتبة، خصوصًا إذا كنت تتبع شرحًا قديمًا أو تعمل على مشروع يحتاج نسخة محددة.

python -m pip install "requests==2.31.0"

معنى هذا الأمر: ثبّت مكتبة requests بالإصدار 2.31.0 تحديدًا.

ويمكنك أيضًا تحديد نطاق للإصدارات:

python -m pip install "requests>=2.0,<3.0"

هذا يعني: ثبّت إصدارًا من requests يكون أكبر أو يساوي 2.0 وأقل من 3.0.

تحديث مكتبة مثبتة باستخدام pip

إذا كانت المكتبة مثبتة مسبقًا وتريد تحديثها إلى إصدار أحدث، استخدم:

python -m pip install --upgrade requests

ويمكن اختصار --upgrade إلى:

python -m pip install -U requests

لكن للمبتدئين، كتابة الأمر كاملًا أوضح وأفضل في البداية.

حذف مكتبة باستخدام pip

إذا لم تعد تحتاج مكتبة معينة، يمكنك حذفها بالأمر التالي:

python -m pip uninstall requests

سيطلب منك pip تأكيد الحذف، وغالبًا ستكتب:

y

بعدها سيتم حذف المكتبة من البيئة الحالية.

عرض المكتبات المثبتة

لمعرفة المكتبات المثبتة حاليًا في بيئتك، استخدم:

python -m pip list

سيظهر لك جدول يحتوي على أسماء المكتبات وإصداراتها.

وإذا أردت إخراج القائمة بشكل مناسب للحفظ في ملف متطلبات المشروع، استخدم:

python -m pip freeze

الفرق بين pip list و pip freeze أن الأولى تعرض قائمة سهلة القراءة، أما الثانية فتعرض المكتبات بصيغة مناسبة لملف requirements.txt.

ما هو ملف requirements.txt؟

ملف requirements.txt هو ملف نصي يحتوي على أسماء المكتبات التي يحتاجها المشروع. هذا الملف مهم جدًا عندما تريد نقل المشروع إلى جهاز آخر، أو رفعه على GitHub، أو مشاركته مع شخص آخر.

مثال على محتوى الملف:

requests==2.31.0
beautifulsoup4==4.12.3
pandas==2.2.2

لإنشاء هذا الملف من المكتبات المثبتة في البيئة الحالية:

python -m pip freeze > requirements.txt

ولتثبيت جميع المكتبات الموجودة داخل الملف:

python -m pip install -r requirements.txt

متى تستخدم requirements.txt؟ استخدمه عندما يصبح مشروعك معتمدًا على أكثر من مكتبة، أو عندما تريد مشاركة المشروع بطريقة احترافية. {alertInfo}

لماذا البيئة الافتراضية venv مهمة مع pip؟

من الأخطاء الشائعة عند المبتدئين تثبيت كل المكتبات على النظام مباشرة. هذا قد يسبب تداخلًا بين المشاريع؛ فربما مشروع يحتاج إصدارًا قديمًا من مكتبة معينة، ومشروع آخر يحتاج إصدارًا أحدث.

الحل الأفضل هو استخدام بيئة افتراضية لكل مشروع. البيئة الافتراضية تجعل مكتبات المشروع معزولة عن باقي المشاريع.

لإنشاء بيئة افتراضية:

python -m venv venv

لتفعيلها في Windows:

venv\Scripts\activate

ولتفعيلها في Linux أو macOS:

source venv/bin/activate

بعد التفعيل، أي مكتبة تثبتها باستخدام pip سيتم تثبيتها داخل هذه البيئة فقط.

مثال عملي: إنشاء مشروع صغير وتثبيت مكتبة

لنفترض أننا نريد إنشاء مشروع بسيط يستخدم مكتبة requests لجلب حالة موقع.

الخطوة 1: إنشاء مجلد المشروع

mkdir pip_demo_project
cd pip_demo_project

الخطوة 2: إنشاء بيئة افتراضية

python -m venv venv

الخطوة 3: تفعيل البيئة

في Windows:

venv\Scripts\activate

في Linux/macOS:

source venv/bin/activate

الخطوة 4: تثبيت مكتبة requests

python -m pip install requests

الخطوة 5: كتابة ملف Python

أنشئ ملفًا باسم main.py واكتب:

import requests

url = "https://example.com"
response = requests.get(url)

print("Status code:", response.status_code)

الخطوة 6: تشغيل الملف

python main.py

إذا ظهرت لك نتيجة مثل 200 فهذا يعني أن الكود يعمل وأن المكتبة تم تثبيتها بنجاح.

أوامر pip المهمة للمبتدئين

الأمر	الوظيفة	مثال
pip --version	معرفة إصدار pip	python -m pip --version
pip install	تثبيت مكتبة	python -m pip install requests
pip uninstall	حذف مكتبة	python -m pip uninstall requests
pip list	عرض المكتبات المثبتة	python -m pip list
pip freeze	عرض المكتبات بصيغة مناسبة للمتطلبات	python -m pip freeze
pip install -r	تثبيت مكتبات من ملف requirements	python -m pip install -r requirements.txt
pip install --upgrade	تحديث مكتبة	python -m pip install --upgrade requests

أخطاء شائعة عند استخدام pip وحلولها

1. ظهور pip is not recognized

هذا الخطأ يظهر غالبًا في Windows عندما لا يستطيع النظام الوصول إلى pip من موجه الأوامر.

جرّب بدلًا من:

pip install requests

استخدم:

python -m pip install requests

إذا لم يعمل أيضًا، فتأكد من تثبيت Python بشكل صحيح وتفعيل خيار إضافة Python إلى PATH أثناء التثبيت.

2. ظهور No module named pip

هذا يعني أن pip غير متوفر في نسخة Python التي تستخدمها. يمكنك تجربة:

python -m ensurepip --upgrade

ثم جرّب تحديث pip:

python -m pip install --upgrade pip

3. تثبيت المكتبة لكن import لا يعمل

قد يحدث هذا عندما تثبت المكتبة في نسخة Python وتستخدم نسخة أخرى لتشغيل الكود. الحل:

• استخدم python -m pip install package_name.
• تأكد أنك فعّلت البيئة الافتراضية قبل التثبيت.
• تأكد أن محرر الكود يستخدم نفس مفسر Python الذي ثبتت عليه المكتبة.

يمكنك قراءة درسنا عن شرح Modules و import في Python لفهم الفرق بين تثبيت المكتبة واستدعائها داخل الكود.

4. ظهور Permission denied أو Access is denied

هذا يعني أن pip لا يملك صلاحية الكتابة في مكان التثبيت. الأفضل للمبتدئ هنا ليس استخدام صلاحيات المدير مباشرة، بل إنشاء بيئة افتراضية للمشروع ثم تثبيت المكتبة داخلها.

تنبيه مهم: لا تستخدم أوامر بصلاحيات عالية مثل sudo عشوائيًا عند تثبيت مكتبات Python، خصوصًا إذا كنت لا تعرف أثرها على النظام. استخدم البيئة الافتراضية أولًا. {alertWarning}

5. تثبيت مكتبة باسم خطأ

أحيانًا يكتب المبتدئ اسم المكتبة بشكل غير صحيح. مثلًا قد تكون المكتبة تُثبّت باسم وتُستدعى داخل الكود باسم مختلف، أو العكس.

مثال شائع:

python -m pip install beautifulsoup4

ثم داخل الكود:

from bs4 import BeautifulSoup

لذلك من الأفضل دائمًا قراءة صفحة المكتبة على PyPI أو التوثيق الرسمي لمعرفة اسم التثبيت الصحيح واسم الاستيراد الصحيح.

هل pip يثبت مكتبات من PyPI فقط؟

الاستخدام الأكثر شيوعًا هو تثبيت المكتبات من PyPI، وهو مستودع ضخم لحزم Python. لكن pip يمكنه أيضًا تثبيت مكتبات من ملفات محلية أو روابط Git أو مصادر أخرى، وهذا موضوع متقدم نسبيًا.

للمبتدئ، يكفي في البداية فهم هذا الشكل:

python -m pip install package_name

ثم لاحقًا يمكنك التوسع في قراءة التوثيق الرسمي:

• توثيق pip الرسمي
• دليل Python Packaging لتثبيت الحزم
• توثيق Python الرسمي عن البيئات الافتراضية
• موقع PyPI الرسمي

متى أستخدم pip ومتى لا أستخدمه؟

الحالة	هل تحتاج pip؟	السبب
استخدام print أو input أو len	لا	هذه أوامر ودوال أساسية في Python
استخدام مكتبة math أو random	لا غالبًا	هذه من المكتبات القياسية المرفقة مع Python
استخدام requests أو pandas	نعم	هذه مكتبات خارجية تحتاج تثبيت
تشغيل كود يحتوي على import لمكتبة غير موجودة	غالبًا نعم	يجب تثبيت المكتبة أولًا إذا لم تكن موجودة

ولفهم المكتبات والاستيراد بشكل أفضل، راجع درس شرح Modules و import في Python للمبتدئين.

أفضل طريقة لاستخدام pip للمبتدئين

حتى لا تتلخبط، اتبع هذه القاعدة البسيطة في أي مشروع Python:

1. أنشئ مجلدًا خاصًا بالمشروع.
2. أنشئ بيئة افتراضية باستخدام venv.
3. فعّل البيئة الافتراضية.
4. ثبّت المكتبات باستخدام python -m pip install.
5. احفظ المتطلبات في requirements.txt عند الحاجة.
6. استورد المكتبات داخل كود Python باستخدام import.

بهذه الطريقة سيكون مشروعك مرتبًا، وستقل مشاكل تعارض المكتبات والإصدارات.

روابط داخلية مقترحة لفهم الدرس بشكل أفضل

إذا كنت ما زلت في بداية تعلم Python، فهذه الدروس ستساعدك على فهم pip ضمن الصورة الأكبر:

• شرح Modules و import في Python للمبتدئين
• شرح try و except في Python والتعامل مع الأخطاء
• أفضل مصادر تعلم بايثون من الصفر مجانًا للمبتدئين
• تمارين بايثون للمبتدئين مع الحلول

تمرين بسيط على pip

جرّب تطبيق هذا التمرين بنفسك:

1. أنشئ مجلدًا باسم weather_test.
2. أنشئ بيئة افتراضية داخله.
3. ثبّت مكتبة requests.
4. أنشئ ملف main.py.
5. اكتب كودًا يطبع حالة الاستجابة من موقع https://example.com.
6. أنشئ ملف requirements.txt يحتوي على مكتبات المشروع.

هذا التمرين البسيط سيجعلك تفهم عمليًا كيف تنتقل من تثبيت مكتبة إلى استخدامها داخل برنامج Python.

الخلاصة

أداة pip من أهم الأدوات التي يحتاجها أي شخص يتعلم Python، لأنها تفتح لك باب استخدام آلاف المكتبات الجاهزة. بدل أن تكتب كل شيء من الصفر، يمكنك تثبيت مكتبة مناسبة واستخدامها داخل مشروعك.

لكن المهم أن تستخدم pip بطريقة صحيحة: شغّله من Terminal، ويفضل عبر python -m pip، واستخدم بيئة افتراضية لكل مشروع، ولا تخلط بين أمر التثبيت pip install وأمر الاستدعاء داخل الكود import.

الخلاصة العملية: ثبّت المكتبة باستخدام pip، ثم استدعها داخل الكود باستخدام import، واجعل لكل مشروع بيئته الافتراضية الخاصة. {alertSuccess}

أسئلة شائعة مع إجاباتها

هل pip يأتي مع Python؟

في أغلب تثبيتات Python الحديثة يكون pip متاحًا تلقائيًا، لكن في بعض الأنظمة أو طرق التثبيت قد تحتاج إلى تثبيته أو تفعيله يدويًا.

هل أكتب pip install داخل ملف Python؟

لا. أمر pip install يُكتب في Terminal أو موجه الأوامر، وليس داخل ملف .py. داخل ملف Python تستخدم import فقط.

ما الفرق بين pip و PyPI؟

pip هو الأداة التي تثبت بها المكتبات، أما PyPI فهو المستودع الذي تُنشر عليه كثير من مكتبات Python.

لماذا تظهر رسالة ModuleNotFoundError بعد تثبيت المكتبة؟

غالبًا لأنك ثبتت المكتبة في بيئة أو نسخة Python مختلفة عن النسخة التي تشغل بها الكود. استخدم python -m pip وتأكد من تفعيل البيئة الافتراضية الصحيحة.

هل يجب استخدام بيئة افتراضية دائمًا؟

ليست إجبارية في كل تجربة صغيرة، لكنها أفضل عادة عند العمل على مشاريع حقيقية؛ لأنها تمنع تداخل المكتبات بين المشاريع.

ما الأمر الأفضل لتثبيت مكتبة للمبتدئين؟

الأفضل استخدام:

python -m pip install package_name

مع استبدال package_name باسم المكتبة التي تريد تثبيتها.