0.2تثبيت Python ومحرر (VS Code / PyCharm)
الأساسي في 30 ثانية
- أداتان، ودوران : المفسّر (Interpréteur) يُنفِّذ، والمحرر يكتب — ثبِّت Python من الموقع الرسمي، بالإصدار 3.
- على Windows، علِّم PATH : « Add Python to PATH » تجعل الأمر python صالحا في كل مكان — ونسيانه هو الفخ رقم 1.
- تحقق بالثلاثية : الأمر python، والأمر pip، ثم ملف .py يُنفَّذ من VS Code.
حالة مستمرة — نبيل يُجهِّز جهازه في الجزائر
نبيل، محلل بيانات مبتدئ في الجزائر، استلم حاسوبا فارغا ويجب أن يُعِدّ جهاز Python قبل أي حساب. ثبَّت المفسّر من الموقع الرسمي، وعلَّم خيار PATH على Windows ليستجيب الأمر python في كل مكان، وتأكد في الطرفية (Terminal) من استجابة اللغة وأداة التثبيت، ثم ثبَّت VS Code مع إضافة Python وحدَّد مفسّره. أنشأ مجلد عمل وملف test.py : ثلاث علامات خضراء، وورشته جاهزة لتحليل أول مبيعاته.
حالة مستقلة لهذا القسم : تعود في الدرس والمخطط والنص الجاهز وتحدي 48 ساعة للقسم 0.2.
1. ثبِّت دون خطأ
حمِّل Python من الموقع الرسمي، بالإصدار 3 (أبدا الإصدار 2، المتوقف)، وعلى Windows علِّم « Add Python to PATH » قبل النقر على Install. وPATH هو قائمة المجلدات التي يبحث فيها النظام عن البرامج : تعليمه يجعل الأمر python صالحا في كل مكان في الطرفية. تحقق فورا عبر python --version (أو python3 --version حسب النظام) : فإذا استجابت الطرفية، فالمفسّر مثبت جيدا. يتحقق نبيل قبل المتابعة : لا استجابة، لا متابعة.
2. VS Code : المحرر المتسامح
VS Code (مجاني) مع إضافة Python يمنح تلوينا، وتنفيذا بنقرة، وطرفية مدمجة وتصحيحا. بعد التثبيت، حدِّد المفسّر الذي سيُنفِّذ كودك — فهو الذي يهم، لا المحرر. والبديل PyCharm (نسخة Community المجانية) بيئة متكاملة (IDE) محبوبة للمشاريع الكبيرة، لكن VS Code الأخف يكفي للبدء. يثبِّت نبيل الإضافة، ويحدِّد مفسّره، ويفتح مجلد عمله في المحرر.
3. ثلاثية التحقق
ثلاث علامات خضراء تُثبِت الجهاز : الأمر python (اللغة تستجيب)، والأمر pip (مثبت الحزم يستجيب — وسيُستخدم لإضافة مكتبات المنظومة)، وملف .py يُنفَّذ من VS Code. هذه الثلاثية تعزل أي عطل مستقبلي : فإذا توقف أمر عن الاستجابة، عرفنا بالضبط أي لبنة هي السبب. ينشئ نبيل test.py في مجلد عمله ويُنفِّذه : فورشته للتطوير جاهزة للقسم التالي.
🔎 مثال ملموس — 🔎 مثال ملموس — تحقق كامل
الثلاثية التي تثبت أن جهاز نبيل جاهز.
# في الطرفية (Windows : PowerShell ، وmacOS/Linux : Terminal) :
# $ python --version
# $ pip --version
# ثم في VS Code : إضافة Python مثبتة، والمفسّر محدد
print("جهاز نبيل : جاهز")
القراءة : يكتب نبيل الأمرين : فإذا استجابت الطرفية، فاللغة والمثبت متوافقان ؛ والسكربت يؤكد التنفيذ من المحرر.
الدرس : عند أي عطل مستقبلي، نعيد هذه الثلاثية لعزل اللبنة الخاطئة.
مفردات القسم
- مفسّر Python
- البرنامج الذي يقرأ كودك ويُنفِّذه. نستدعيه بالأمر python (أو python3 حسب النظام).
مثال بسيط: يكتب نبيل python في الطرفية فيستجيب المفسّر.
ما ليس كذلك: المحرر، الذي لا يفعل سوى كتابة الكود.
رد فعل: عند الشك، تحقق أولا من استجابة python.
- PATH
- قائمة المجلدات التي يبحث فيها النظام عن البرامج. تعليم « Add Python to PATH » يجعل الأمر python صالحا في كل مكان.
مثال بسيط: يعلِّم نبيل الخيار في الجزائر ويُشغِّل python من أي مجلد.
ما ليس كذلك: كلمة مرور أو خيار زخرفي.
رد فعل: « python غير معروف » = فكِّر في PATH أولا.
- محرر / بيئة متكاملة
- برنامج لكتابة الكود، مع تلوين وأدوات. VS Code محرر قابل للتوسيع وشائع جدا ؛ وPyCharm بيئة متكاملة (IDE) مخصصة.
مثال بسيط: يكتب نبيل test.py في VS Code بدلا من المفكرة.
ما ليس كذلك: البرنامج الذي يُنفِّذ الكود مكان المفسّر.
رد فعل: اكتب في المحرر، ونفِّذ بالمفسّر.
- VS Code
- محرر مجاني واسع الانتشار. مع إضافة Python، يمنح التنفيذ والإكمال التلقائي والتصحيح.
مثال بسيط: يثبِّت نبيل إضافة Python ويحدِّد مفسّره.
ما ليس كذلك: لغة برمجة منافسة.
رد فعل: بعد التثبيت، حدِّد المفسّر صراحة.
- الطرفية
- نافذة تُكتَب فيها أوامر نصية. على Windows : PowerShell ؛ وعلى macOS وLinux : الطرفية (Terminal).
مثال بسيط: يكتب نبيل فيها python --version للتحقق من تثبيته.
ما ليس كذلك: منطقة نص في صفحة ويب.
رد فعل: تحقق من كل تثبيت بأمر، لا بالنظر.
في التطبيق — عمليا — ثبِّت Python وVS Code بنظافة
- حمِّل Python من الموقع الرسمي (الإصدار 3). وعند التثبيت على Windows، علِّم حتما « Add Python to PATH » قبل النقر على Install.
- تحقق في طرفية : اكتب « python --version » (أو « python3 --version ») — فالرقم المعروض يثبت استجابة المفسّر.
- ثبِّت VS Code، ثم في تبويب الإضافات، ثبِّت إضافة « Python » وحدِّد مفسّرك.
- أنشئ مجلد عمل، وافتحه في VS Code، وأنشئ ملف « test.py » للتحقق من عمل كل شيء في القسم التالي.
نص جاهز — أعلِن جهازك جاهزا (30 ثانية)
« الجهاز جاهز : Python مثبتة من الموقع الرسمي مع خيار PATH، وpython وpip يستجيبان في الطرفية، وVS Code مع إضافة Python والمفسّر محدد. ملف test.py يُنفَّذ — ومثل نبيل، أستطيع مهاجمة أول برنامج. »
يُقال مع عرض الطرفية المستجيبة وملف test.py المُنفَّذ في VS Code.
قالب جاهز للنسخ — تحقق من جهازك
# test.py — التحقق من جهاز نبيل
import sys
print("جهاز نبيل : OK")
print(sys.version)
print("إذا ظهر هذان السطران، فالمفسّر يستجيب. ")
نسيان PATH
الطرفية ترد « غير معروف » : أعد تشغيل المثبت، واختر Modify وعلِّم خيار PATH بدلا من إعادة التثبيت عشوائيا.
الأمر python3
إذا لم يستجب python لكن python3 يستجيب، فاستخدم python3 وpip3 : فنظامك يميز الاسمين للتثبيت نفسه.
جهاز مشترك في الجزائر
يُدوِّن نبيل المفسّر المحدَّد على بطاقة الجهاز المشترك : يتحقق كل واحد من التحديد عند الوصول، دون تكديس التثبيتات.
استدراك الاختلاط
تثبيتان يختلطان : أزل النسخة القديمة، وأبقِ تثبيتا واحدا نظيفا، ثم أعد ثلاثية التحقق.
✓ ممارسات جيدة
- ثبِّت من الموقع الرسمي، بإصدار 3 حديث.
- علِّم PATH على Windows.
- حدِّد المفسّر في VS Code.
✗ أخطاء شائعة
- تثبيت Python 2 (المتوقف منذ زمن).
- نسيان PATH (« python غير معروف »).
- تكديس تثبيتات تختلط ببعضها.
النقاط الأساسية
- أداتان : مفسّر Python (يُنفِّذ) + محرر مثل VS Code (يكتب) — والمحرر لا يُنفِّذ شيئا وحده.
- الفخ رقم 1 على Windows : نسيان تعليم « Add Python to PATH » عند التثبيت.
- تحقق دائما من التثبيت بالأمر python والأمر pip.
- VS Code + إضافة Python = بيئة مجانية ومهنية، والمفسّر محدد.
تحدي 48 ساعة — طبِّق غدا
ثبِّت الجهاز على طريقة نبيل، ونفِّذ قالب test.py، ودوِّن ما يرد به كل أمر من الثلاثية.
- الأمران python وpip يستجيبان في طرفيتي.
- VS Code فيه إضافة Python والمفسّر محدد.
- ملف test.py يُنفَّذ : فورشته جاهزة.
أسئلة شائعة
« python » غير معروف في الطرفية، ماذا أفعل؟
إنه غالبا نسيان « Add Python to PATH ». الأسهل : إعادة تشغيل المثبت، واختيار « Modify » وتعليم خيار PATH ؛ أو إعادة التثبيت مع تعليمه. جرِّب أيضا الأمر « python3 » (أو « py » على Windows) حسب نظامك.
هل نختار VS Code أم PyCharm؟
كلاهما ممتاز ومجاني (PyCharm بنسخة Community). VS Code أخف ومتعدد الاستخدامات، ومثالي للبدء ؛ وPyCharm بيئة متكاملة محبوبة للمشاريع الكبيرة. ابدأ مع VS Code.
على Windows، أي نسيان يسبب « python غير معروف »؟