كيفية تشغيل بايثون و بيب على نظام ويندوز

لتشغيل بايثون وpip على نظام ويندوز ، ثبّت مدير تثبيت بايثون الرسمي، وافتح PowerShell، وشغّل بايثون من سطر الأوامر. عادةً ما يكون pip مُضمّنًا مع بايثون. استخدمه python -m pipللتأكد من تشغيل أوامر الحزمة عبر المفسّر الذي تنوي استخدامه، وأنشئ بيئة افتراضية لكل مشروع لفصل تبعياته.

لم تعد التعليمات القديمة التي توصي بالاختيار من بين إصدارات متجر مايكروسوفت الثابتة أو التنزيل get-pip.pyهي الطريقة الأسهل للتثبيت. توصي وثائق بايثون الحالية باستخدام مدير تثبيت بايثون، المتوفر على موقع Python.org أو متجر مايكروسوفت. يتولى هذا المدير إدارة بيئات تشغيل بايثون، ensurepipويمكنه استعادة pip في حال كان مفقودًا في تثبيت معين.

1. تثبيت بايثون على نظام ويندوز

1. افتح صفحة تنزيلات بايثون الرسمية ، أو افتح متجر مايكروسوفت وابحث عن مدير تثبيت بايثون . كلا التوزيعتين متطابقتان. تأكد من أن الناشر هو مؤسسة برمجيات بايثون، ثم ثبّت التطبيق.
2. افتح نافذة PowerShell جديدة. شغّل الأمر python --version. إذا لم يكن وقت تشغيل Python مثبتًا بعد، فسيقوم المدير بتثبيت أحدث إصدار مستقر عند تشغيل Python لأول مرة. يمكنك أيضًا تشغيل الأمر py listلعرض أوقات التشغيل التي يعرفها المدير.
3. إذا كان المشروع يتطلب إصدارًا محددًا من بايثون، فقم بتثبيت ذلك الإصدار صراحةً، على سبيل المثال py install 3.15. تحقق من متطلبات المشروع قبل اختيار الإصدار؛ فالإصدار الأحدث ليس متوافقًا تلقائيًا مع جميع التطبيقات القديمة.

لإعداد جديد، pythonعادةً ما يكون الأمر الافتراضي كافيًا. تحقق من النتيجة باستخدام:

python --version
py list

يعرض الأمر الأول إصدار المفسر، بينما يسرد الأمر الثاني بيئات التشغيل المثبتة. يتغير رقم الإصدار الدقيق مع كل إصدار جديد من بايثون. لتشغيل سكربت من مجلده، استخدم الأمر ` python .\script.py. لمزيد من التفاصيل حول مدير بايثون، والأسماء المستعارة، وإعدادات ويندوز، راجع دليل بايثون الرسمي على ويندوز .

2. افحص الأنبوب وقم بإصلاحه فقط إذا لزم الأمر

تأكد من أن pip متصل بمفسر بايثون الذي قمت بتثبيته للتو:

python -m pip --version

يُحدد الناتج برنامج pip وإصدار بايثون الذي ينتمي إليه. إذا نجح الأمر، يمكنك تحديث pip باستخدام الأمر التالي:

python -m pip install --upgrade pip

إذا أبلغت لغة بايثون عن وجود خطأ No module named pip، فاستخدم وحدة bootstrap المدمجة في بايثون بدلاً من تنزيل برنامج نصي منفصل:

python -m ensurepip --upgrade

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

3. تثبيت الحزم في بيئة المشروع

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

py -m venv .venv
.\.venv\Scripts\Activate.ps1

بعد التفعيل، عادةً ما يضيف PowerShell (.venv)إلى موجه الأوامر. قم بتثبيت حزمة باستخدام نفس الأمر المرتبط بالمفسر المستخدم أعلاه:

python -m pip install requests

استبدل requestsباسم الحزمة التي يحتاجها مشروعك. لعرض ما تم تثبيته باستخدام pip، شغّل الأمر python -m pip show requests. عند الانتهاء من العمل في البيئة، أدخل deactivate. تبقى البيئة محفوظة على القرص ويمكن تفعيلها لاحقًا.

عندما يحظر PowerShell تنفيذ البرامج Activate.ps1النصية بسبب سياسة تنفيذ البرامج النصية الخاصة به، لا تحتاج إلى تغيير إعدادات الجهاز بالكامل لمجرد تثبيت حزمة. بدلاً من ذلك، استدعِ مترجم البيئة مباشرةً.

.\.venv\Scripts\python.exe -m pip install requests

يُشغّل هذا الأمر pip داخل تلك البيئة دون تفعيلها. يشرح دليل بايثونvenv كيفية إنشاء البيئات واستخدامها على نظام ويندوز.

إصلاح المشاكل الشائعة في بايثون و pip

• إذا لم يتم العثور على بايثون أو إذا فتح الأمر متجر التطبيقات، فتأكد من تثبيت مدير التثبيت، ثم افتح قائمة ابدأ وابحث عن " إدارة أسماء التطبيقات المستعارة" . تأكد Python (default)من تفعيلها؛ إذا كانت مُفعّلة بالفعل، فأوقفها ثم أعد تفعيلها لتحديث الأمر. ثم حاول تشغيله py list. راجع خطوات استكشاف أخطاء Windows الرسمية لحل مشكلات الأسماء المستعارة أو تعارضات وقت التشغيل الأخرى.
• "لم يتم التعرف على pip": قم بتشغيل الأمر python -m pipبدلاً من pipالأمر المستقل. هذا يتجنب الاعتماد على إضافة مجلد Scripts منفصل إلى PATH.
• يتم تثبيت الحزم في إصدار بايثون خاطئ: قارن python --versionمع python -m pip --versionالإصدار الصحيح. إذا كنت تحتفظ بإصدارات متعددة، فاختر الإصدار المطلوب باستخدام مشغل ويندوز، على سبيل المثال py -3.15 -m pip --version.

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