كيفية تشغيل ملف بايثون من الترمينال أو محرر الأكواد

ثلاث طرق لتشغيل بايثون، ومتى تستخدم كل واحدة

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

الخيارات الثلاثة هي:

1. الـ interactive shell — موجّه تفاعلي مباشر ينفّذ كل سطر بمجرد ما تكتبه.
2. ملف .py محفوظ وتشغيله من الترمينال — الطريقة المعتادة لتشغيل أي سكربت بايثون حقيقي.
3. زر "Run" في المحرر — اختصار للخيار الثاني لما تكون شغّال داخل VS Code أو PyCharm أو ما شابه.

راح نمرّ على كل واحدة، وبعدها نحكي متى تختار أيّها.

الـ Interactive Shell (ممتازة للتجربة السريعة)

افتح الترمينال واكتب:

python3

سيظهر أمامك الموجِّه >>>، وكل سطر تكتبه يُنفَّذ على الفور. هذه الطريقة مثالية لتجربة أسطر برمجية سريعة، أو لتذكّر ما تفعله دالة معيّنة، أو لاختبار تعبير صغير دون الحاجة إلى إنشاء ملف كامل:

>>> 2 + 2
4
>>> name = "Ada"
>>> f"Hello, {name}"
'Hello, Ada'

عند الانتهاء، اكتب exit() أو اضغط Ctrl-D.

الـ shell مجرّد مسودّة للتجارب. ممتاز للاستكشاف السريع، لكنه لا يحفظ أي شيء. بمجرد أن تُغلق النافذة، يختفي كل ما كتبته. لهذا السبب، أول ما تحتاج للاحتفاظ بالكود، تنتقل إلى ملف.

تشغيل ملف بايثون محفوظ بامتداد .py

هكذا يُشغَّل 99% من كود بايثون فعليًا — من ملف، عبر الترمينال. الخطوات ثابتة دائمًا:

1. أنشئ ملفًا نصيًا عاديًا بامتداد .py. الاسم يعود إليك؛ hello.py خيار جيد.
2. اكتب بداخله بعض أكواد بايثون.
3. افتح الترمينال داخل المجلد الذي يحتوي الملف.
4. نفّذ الأمر python3 hello.py.

وهذا أبسط سكربت ممكن. احفظه في ملف باسم hello.py:

ثم من الترمينال:

python3 hello.py

لا بد أن تظهر لك ثلاثة أسطر في المخرجات. هذا كل شيء — هذه هي دورة العمل الكاملة. كل درس تعليمي، وكل نشر في بيئة الإنتاج، وكل مهمة cron، وكل خط معالجة بيانات، ما هو إلا صورة من صور "تشغيل ملف .py".

هناك بعض النقاط التي تستحق الانتباه في هذا الأمر:

• python3 هو المفسّر (interpreter). على ويندوز، يكفي عادةً كتابة python.
• hello.py هو مسار نسبي إلى المجلد الحالي. إذا كنت في مجلد خاطئ، فستظهر لك رسالة No such file or directory — تحقق من موقع الترمينال الحالي باستخدام pwd على macOS/Linux أو cd على ويندوز، ثم انتقل إلى المجلد الصحيح.
• تقوم بايثون بتنفيذ الملف مرة واحدة، من أوله إلى آخره، ثم تخرج. ولا تُبقي أي شيء يعمل في الخلفية بعد ذلك.

تشغيل سكربت بايثون من المحرر

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

• VS Code مع إضافة Python الرسمية. اضغط على زر التشغيل في أعلى النافذة، أو استخدم مفتاح F5.
• PyCharm، الذي يمتلك نظامه الخاص لإعدادات التشغيل (Run configurations).

كلاهما يقوم بنفس ما فعلته يدويًا — أي استدعاء python3 your_file.py خلف الكواليس، داخل ترمينال مدمج في المحرر. لا سحر هنا ولا تعقيد. وإذا حدث أي خلل، يمكنك دائمًا العودة إلى تشغيل الملف بنفسك من الترمينال.

عادة مفيدة: حتى عند الضغط على زر التشغيل داخل المحرر، ألقِ نظرة على الأمر الذي يعرضه. إذا وجدت شيئًا مثل /opt/homebrew/bin/python3.12 hello.py، فهذا يخبرك بالضبط أي مفسّر بايثون تم استخدامه. معظم المشاكل المحيّرة المتعلقة بالمفسّر (حيث يبدو أن pip install يعمل، لكن import لا يجد المكتبة) سببها الأساسي وجود نسختين مختلفتين من بايثون على نفس الجهاز.

تمرير مُدخلات إلى السكربت

السكربت ليس دائمًا عملية تُنفَّذ مرة واحدة فقط. في كثير من الأحيان تحتاج إلى تمرير مُدخلات له أثناء تشغيله. وأبسط طريقة لذلك هي عبر دالة input():

عندما تشغّل هذا الكود في ترمينال حقيقي، سينتظر منك أن تكتب شيئًا وتضغط Enter. يمكنك أيضًا تجربة المقطع أعلاه مباشرة هنا في المتصفح — بيئة التشغيل المدمجة ستتكفّل بالتعامل مع طلب الإدخال نيابةً عنك.

ماذا تفعل عندما لا ينتهي السكربت؟

معظم سكربتات بايثون تعمل مرة واحدة ثم تخرج. لكن بعضها يظل يعمل بلا توقف — مثل خادم ويب، أو بوت يراقب مجلدًا لرصد الملفات الجديدة. إذا كتبت حلقة لا نهائية بالخطأ وبدا لك أن الترمينال قد تجمّد، فاعلم أن هذا هو السبب: السكربت لا يزال يعمل. اضغط Ctrl-C لإيقافه، فهذا الاختصار هو زر إعادة الضبط لأي شيء يعلق معك.

اختر أدواتك ثم انسَ أمرها

كل ما سيأتي في هذه الدروس يفترض أنك قادر على تشغيل مقطع كود — إما بلصقه في ملف وتنفيذ الأمر python3 file.py، أو باستخدام المحرر المدمج داخل الصفحة. أما أي أداة ستستعملها لذلك فالخيار يعود لك، والإجابة الصحيحة عادةً ما تتغير مع تطوّر مسارك المهني. ابدأ بأبسط ما يمكن: محرر نصوص عادي مع ترمينال يكفيانك تمامًا خلال الأسابيع المقبلة.

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