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

أداة pip هي الطريقة الأشهر لتثبيت وإدارة مكتبات بايثون الخارجية. فإذا أردت تثبيت مكتبة مثل requests أو pandas، فستستخدم أمرًا مثل python -m pip install requests داخل Terminal أو CMD.

في هذا الدليل ستتعلم شرح pip في بايثون للمبتدئين خطوة بخطوة: تثبيت المكتبات، تحديثها وحذفها، الفرق بين pip install وimport، استخدام requirements.txt وvenv، وحل أشهر مشاكل pip.

{alertInfo} الإجابة المختصرة: استخدم python -m pip install package_name في Terminal لتثبيت المكتبة، ثم استخدم import داخل ملف بايثون لاستدعائها في الكود.

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

ملخص سريع: أهم أوامر pip للمبتدئين

إذا كنت تريد الاختصار، فهذا الجدول يجمع أهم أوامر pip التي ستحتاجها كثيرًا:

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

ما هو pip في بايثون؟

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

مثال:

python -m pip install requests

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

import requests

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

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

كثير من المبتدئين يخلطون بين pip وimport. الفرق بسيط:

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

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

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

كيف تتأكد أن 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، فالمشكلة غالبًا في تثبيت بايثون أو إعداد PATH أو في أن pip غير متاح داخل البيئة التي تستخدمها.

تحديث pip نفسه

إذا أردت تحديث pip إلى إصدار أحدث داخل البيئة الحالية، استخدم:

python -m pip install --upgrade pip

لا تحتاج إلى تحديث pip قبل كل تثبيت، لكن التحديث قد يساعد عندما تكون نسختك قديمة أو عند ظهور مشاكل توافق مرتبطة بأداة التثبيت.

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

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

pip install requests

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

python -m pip install requests

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

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

طريقة تثبيت مكتبة بايثون باستخدام pip

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

python -m pip install requests

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

import requests

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

print(response.status_code)

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

إذا أردت التأكد من معلومات الحزمة المثبتة وإصدارها ومكانها، استخدم:

python -m pip show requests

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

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

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

لإنشاء ملف يحتوي على جميع الحزم المثبتة في البيئة الحالية بصيغة مناسبة لـ requirements.txt:

python -m pip freeze > requirements.txt

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

python -m pip install -r requirements.txt

{alertInfo} متى تستخدم requirements.txt؟ استخدمه عندما تريد تسجيل اعتمادات المشروع أو إعادة تثبيتها على جهاز أو بيئة أخرى. والأفضل إنشاء الملف من بيئة افتراضية مخصصة للمشروع حتى لا يتضمن حزمًا لا يحتاجها.

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

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

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

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

python -m venv venv

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

venv\Scripts\activate

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

source venv/bin/activate

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

{alertSuccess} أفضل ممارسة للمبتدئين: عند إنشاء مشروع جديد، أنشئ بيئة افتراضية أولًا، ثم ثبّت المكتبات داخلها بدل تثبيتها على النظام مباشرة.

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

لنفترض أننا نريد إنشاء مشروع بسيط يستخدم مكتبة 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: كتابة ملف بايثون

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

import requests

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

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

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

python main.py

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

الخطوة 7: الخروج من البيئة الافتراضية عند الانتهاء

deactivate

كيف تعرف أن المكتبة ثبتت في البيئة الصحيحة؟

بعد تثبيت أي مكتبة، لا تعتمد على رسالة التثبيت فقط. استخدم أكثر من خطوة للتأكد أن pip ومفسر بايثون يعملان داخل البيئة نفسها:

1. اعرض إصدار pip باستخدام python -m pip --version.
2. اعرض معلومات الحزمة باستخدام python -m pip show package_name.
3. جرّب استيراد المكتبة من نفس مفسر بايثون.

python -m pip show requests

python -c "import requests; print(requests.__version__)"

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

أشهر أخطاء pip في بايثون وحلولها

1. ظهور pip is not recognized

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

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

pip install requests

استخدم:

python -m pip install requests

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

2. ظهور No module named pip

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

python -m ensurepip --upgrade

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

python -m pip install --upgrade pip

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

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

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

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

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

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

وفي بعض توزيعات Linux الحديثة قد ترى رسالة تفيد بأن بيئة بايثون مُدارة من النظام. في هذه الحالة أيضًا يكون إنشاء venv للمشروع هو الحل الأنظف بدل إجبار pip على التثبيت في بيئة النظام.

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

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

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

مثال شائع:

python -m pip install beautifulsoup4

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

from bs4 import BeautifulSoup

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

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

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

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

python -m pip install package_name

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

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

أفضل طريقة لاستخدام pip في مشاريع بايثون

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

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

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

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

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

مصادر خارجية مفيدة

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

تمرين عملي على pip للمبتدئين

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

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

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

الخلاصة

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

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

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

أسئلة شائعة

هل pip يأتي مع Python؟

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

هل أكتب pip install داخل ملف بايثون؟

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

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

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

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

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

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

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

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

الأفضل استخدام python -m pip install package_name مع استبدال package_name باسم المكتبة التي تريد تثبيتها.

كيف أعرف مكان تثبيت مكتبة بايثون؟

استخدم الأمر python -m pip show package_name، وستجد ضمن النتائج معلومات الحزمة ومسار التثبيت في خانة Location.

ما فائدة ملف requirements.txt؟

ملف requirements.txt يساعدك على حفظ مكتبات المشروع وإصداراتها، ثم تثبيتها لاحقًا على جهاز آخر أو داخل بيئة جديدة باستخدام أمر واحد.