كيف تشغل ملف Python في CMD وTerminal وVS Code؟ دليل للمبتدئين خطوة بخطوة

بعد كتابة أول كود في Python وحفظه داخل ملف ينتهي بالامتداد .py، يظهر سؤال مهم عند أغلب المبتدئين: كيف أشغّل هذا الملف؟ هل أفتحه بالنقر المزدوج؟ هل أكتب أمرًا في CMD؟ هل أستخدم Terminal؟ أم أضغط زر التشغيل في VS Code؟

الإجابة تختلف قليلًا حسب نظام التشغيل والأداة التي تستخدمها، لكن الفكرة واحدة: افتح الطرفية داخل المجلد الصحيح، ثم اطلب من مفسر Python تشغيل الملف. في هذا الدرس ستتعلم الطريقة بوضوح على Windows وmacOS وLinux، بالإضافة إلى تشغيل ملفات Python داخل VS Code وحل أشهر الأخطاء التي قد تمنع الكود من العمل.

{alertInfo} الفكرة ببساطة: لتشغيل ملف Python تحتاج إلى ثلاثة أشياء: Python مثبت على جهازك، وملف محفوظ بامتداد .py، وطرفية مفتوحة داخل المجلد الذي يحتوي على الملف. بعدها تستخدم أمرًا مثل python hello.py أو py hello.py أو python3 hello.py حسب نظامك.

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

قبل تشغيل ملف Python: ماذا تحتاج؟

لا تحتاج إلى برامج معقدة لتشغيل أول ملف Python، لكن تأكد من هذه النقاط:

• تم تثبيت Python على جهازك.
• حفظت الكود داخل ملف مثل hello.py وليس hello.py.txt.
• تعرف مكان المجلد الذي يحتوي على الملف.
• فتحت CMD أو Terminal أو الطرفية المدمجة في VS Code.

للتأكد من وجود Python، افتح الطرفية واكتب أحد الأوامر التالية.

في Windows

python --version

وإذا لم يعمل الأمر، جرّب:

py --version

في macOS أو Linux

python3 --version

إذا ظهرت نسخة مثل Python 3.13.x أو أي إصدار Python 3 مثبت لديك، فأنت جاهز للانتقال إلى تشغيل الملف. أمّا إذا ظهرت رسالة تفيد بأن الأمر غير معروف، فانتقل إلى قسم حل المشكلة لاحقًا في هذا الدرس.

أنشئ أول ملف Python للتجربة

أنشئ مجلدًا على سطح المكتب باسم مثل python-demo. داخله أنشئ ملفًا باسم hello.py واكتب هذا الكود:

name = input("ما اسمك؟ ")

print(f"مرحبًا {name}، أهلاً بك في Python.")

احفظ الملف. تأكد أن اسمه الحقيقي هو:

hello.py

وليس:

hello.py.txt

{alertWarning} تنبيه: في Windows قد تكون امتدادات الملفات مخفية. إذا رأيت اسم الملف hello.py داخل المحرر لكنه لا يعمل، افتح خصائصه أو فعّل عرض امتدادات الملفات من مستكشف الملفات للتأكد أنه ينتهي فعلًا بـ .py.

كيف تشغل ملف Python في CMD على Windows؟

CMD اختصار لـ Command Prompt، وهو نافذة أوامر موجودة في Windows. لتشغيل ملف Python، لا يكفي أن تكتب اسم الملف فقط؛ يجب أن تكون داخل المجلد الذي يحتوي عليه أو تكتب مساره الصحيح.

الخطوة 1: افتح CMD

اضغط زر Windows في لوحة المفاتيح، ثم اكتب cmd وافتح تطبيق Command Prompt.

الخطوة 2: انتقل إلى مجلد الملف باستخدام cd

إذا كان الملف داخل مجلد على سطح المكتب اسمه python-demo، اكتب أمرًا مشابهًا لهذا:

cd Desktop\python-demo

قد يختلف اسم سطح المكتب أو المسار حسب حسابك ولغة نظامك. يمكنك كتابة المسار كاملًا أيضًا:

cd /d "C:\Users\YourName\Desktop\python-demo"

ضع المسار بين علامات اقتباس إذا كان يحتوي على مسافات، مثل مجلد اسمه Python Projects.

للتأكد من وجود الملف داخل المجلد، اكتب:

dir

يجب أن ترى hello.py ضمن قائمة الملفات.

الخطوة 3: شغّل الملف

اكتب:

python hello.py

وفي بعض أجهزة Windows يكون Python Launcher متوفرًا، لذلك يمكنك استخدام:

py hello.py

بعدها سيظهر لك الطلب:

ما اسمك؟

اكتب اسمك واضغط Enter، ثم سيظهر ناتج البرنامج.

كيف تشغل ملف Python في Terminal على macOS وLinux؟

في macOS وLinux تستخدم Terminal بدل CMD. الخطوات قريبة جدًا، لكن غالبًا ستستخدم الأمر python3 بدل python.

الخطوة 1: افتح Terminal

• في macOS: افتح Terminal من التطبيقات أو باستخدام Spotlight.
• في Linux: افتح Terminal من قائمة التطبيقات، أو استخدم الاختصار المناسب لتوزيعتك.

الخطوة 2: انتقل إلى مجلد الملف

إذا كان الملف على سطح المكتب داخل مجلد python-demo، اكتب:

cd ~/Desktop/python-demo

ولعرض الملفات داخل المجلد اكتب:

ls

الخطوة 3: شغّل الملف

python3 hello.py

سبب استخدام python3 في كثير من بيئات macOS وLinux هو التمييز بين Python 3 وأوامر Python القديمة في بعض الأنظمة. استخدم الأمر الذي يعرض لك نسخة Python 3 عند فحص الإصدار.

كيف تشغل ملف Python في VS Code؟

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

1. افتح المجلد الذي يحتوي على ملفك عبر File → Open Folder.
2. افتح الملف hello.py.
3. تأكد من تحديد مفسر Python من شريط الحالة في الأسفل، أو عبر الأمر Python: Select Interpreter.
4. اضغط زر التشغيل ▶ في أعلى يمين المحرر، والذي يحمل عادة اسم Run Python File in Terminal.

سيقوم VS Code بفتح Terminal مدمجة، ثم يشغل الملف باستخدام المفسر المحدد. على Windows يكون الأمر غالبًا شبيهًا بـ python hello.py، وعلى macOS وLinux يكون قريبًا من python3 hello.py.

يمكنك أيضًا النقر بالزر الأيمن داخل الملف ثم اختيار:

Run Python > Run Python File in Terminal

لا تحتاج إلى تثبيت إضافة Code Runner لتشغيل ملفات Python الأساسية داخل VS Code؛ إضافة Python الرسمية توفر طريقة التشغيل في الطرفية.

كيف تشغل الملف من Terminal داخل VS Code يدويًا؟

أحيانًا تريد التحكم بالأمر أو تمرير قيم إضافية إلى البرنامج. افتح الطرفية المدمجة من القائمة:

Terminal > New Terminal

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

python hello.py

وفي macOS وLinux:

python3 hello.py

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

python main.py add "مراجعة درس بايثون"

اقرأ أيضًا درس بناء برنامج سطر أوامر CLI بسيط في Python لفهم كيفية استقبال الأوامر والخيارات داخل مشاريعك.

حل مشكلة python is not recognized في Windows

قد تكتب:

python hello.py

ثم تظهر رسالة قريبة من:

'python' is not recognized as an internal or external command,
operable program or batch file.

المعنى ببساطة: Windows لا يجد مفسر Python عند كتابة الأمر python. لا يعني ذلك بالضرورة أن كودك فيه خطأ.

الحل الأول: جرّب py بدل python

py --version
py hello.py

في كثير من أجهزة Windows يكون Python Launcher متوفرًا حتى عندما لا يعمل أمر python.

الحل الثاني: تأكد من تثبيت Python

افتح إعدادات التطبيقات في Windows وابحث عن Python، أو أعد تشغيل مثبت Python. أثناء التثبيت، تأكد من تفعيل الخيار الذي يضيف Python إلى PATH إذا ظهر لك.

الحل الثالث: أعد فتح CMD أو VS Code

إذا ثبّت Python أو عدّلت PATH وأبقيت نافذة CMD القديمة مفتوحة، قد لا تلتقط التغيير. أغلق CMD وVS Code، ثم افتحهما من جديد وجرب أمر الإصدار مرة أخرى.

الحل الرابع: اعرف مكان Python المتاح

في CMD يمكنك محاولة معرفة مكان الأوامر المتاحة:

where python
where py

إذا ظهر مسار صالح لأحدهما، استخدم الأمر المتوفر. وإذا لم يظهر أي مسار، فغالبًا تحتاج إلى تثبيت Python أو إصلاح PATH.

خطأ: can't open file أو No such file or directory

إذا ظهرت رسالة مثل:

python: can't open file 'hello.py': [Errno 2] No such file or directory

فالمشكلة غالبًا ليست في Python نفسها، بل في مكان الطرفية أو اسم الملف. راجع هذه النقاط:

• هل كتبت cd وانتقلت إلى المجلد الصحيح؟
• هل يظهر الملف عند كتابة dir في Windows أو ls في macOS/Linux؟
• هل اسم الملف بالضبط hello.py؟
• هل الملف محفوظ بامتداد .py وليس .txt؟

يمكنك تشغيله عبر المسار الكامل أيضًا، مثل:

python "C:\Users\YourName\Desktop\python-demo\hello.py"

خطأ: ModuleNotFoundError عند تشغيل الملف

إذا كان البرنامج يبدأ ثم يتوقف برسالة مثل:

ModuleNotFoundError: No module named 'requests'

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

python -m pip install requests

وفي macOS أو Linux:

python3 -m pip install requests

استخدام python -m pip يساعد على ربط pip بمفسر Python الذي تستخدمه في الأمر نفسه. راجع دليل شرح pip في Python وتثبيت المكتبات لتتعلم إنشاء بيئة افتراضية وتثبيت الحزم بطريقة منظمة.

فرق مهم: تشغيل الملف بالنقر المزدوج أم من الطرفية؟

الطريقة	متى تكون مناسبة؟	الملاحظة
النقر المزدوج على ملف .py	تجربة سريعة في Windows إذا كان ربط Python بالملف صحيحًا.	قد تفتح النافذة وتغلق بسرعة، لذلك لا تكون الأفضل للتعلم والتشخيص.
CMD أو Terminal	أفضل طريقة لفهم التشغيل ورؤية الأخطاء وتمرير الأوامر.	تحتاج إلى معرفة المجلد الصحيح وأمر التشغيل.
VS Code	مناسبة للكتابة والتشغيل داخل بيئة واحدة.	تأكد من اختيار Python Interpreter الصحيح.

مثال عملي: تشغيل برنامج آلة حاسبة صغير

أنشئ ملفًا جديدًا باسم calculator.py واكتب:

first_number = float(input("اكتب الرقم الأول: "))
second_number = float(input("اكتب الرقم الثاني: "))

result = first_number + second_number

print(f"الناتج: {result}")

ثم شغّله من الطرفية وأنت داخل المجلد نفسه:

Windows

python calculator.py

macOS / Linux

python3 calculator.py

أو شغله من زر Run Python File in Terminal داخل VS Code.

أخطاء شائعة عند تشغيل ملفات Python

• تشغيل الأمر في المجلد الخطأ: استخدم dir أو ls قبل التشغيل للتأكد أن الملف موجود.
• اسم ملف غير صحيح: تأكد من كتابة الاسم والامتداد كما هو، مثل hello.py.
• استخدام python بدل py أو python3: افحص إصدار Python أولًا وحدد الأمر المتاح على جهازك.
• حفظ الملف بامتداد txt: فعّل عرض الامتدادات في Windows.
• اختيار مفسر خاطئ في VS Code: اختر Interpreter الصحيح، خصوصًا إذا كنت تستخدم بيئة افتراضية.
• تثبيت مكتبة في Python مختلف: استخدم python -m pip install package_name بدل أمر pip وحده عندما تكون غير متأكد.

{alertSuccess} قاعدة عملية: عند ظهور خطأ تشغيل، لا تبدأ بتعديل الكود مباشرة. اقرأ أول سطر مهم من الخطأ، ثم افحص بالترتيب: هل Python موجود؟ هل أنت داخل المجلد الصحيح؟ هل اسم الملف صحيح؟ وهل المفسر المختار هو نفسه الذي ثبتت فيه المكتبات؟

روابط داخلية مفيدة من بايثون العرب

• تجهيز بيئة Python خطوة بخطوة للمبتدئين
• شرح pip في Python: تثبيت مكتبات بايثون وإدارة الحزم
• بايثون بعد الأساسيات 4: بناء برنامج سطر أوامر CLI بسيط
• كورس أساسيات بايثون للمبتدئين

الخلاصة

• لتشغيل ملف Python، احفظه بامتداد .py ثم افتح الطرفية داخل المجلد الذي يحتويه.
• في Windows استخدم غالبًا python file.py أو py file.py.
• في macOS وLinux استخدم غالبًا python3 file.py.
• داخل VS Code اختر Python Interpreter الصحيح ثم اضغط Run Python File in Terminal.
• إذا ظهر python is not recognized، جرّب py، وتأكد من تثبيت Python وPATH ثم أعد فتح الطرفية.
• إذا لم يجد Python الملف، افحص المجلد واسم الملف والامتداد قبل تعديل الكود.

مصادر خارجية رسمية للتوسع

• Command line and environment — Python Documentation
• Running Python code in Visual Studio Code
• Getting Started with Python in VS Code
• Python on Windows for beginners — Microsoft Learn

أسئلة شائعة

كيف أشغل ملف Python في CMD؟

افتح CMD، وانتقل إلى مجلد الملف عبر cd، ثم اكتب python filename.py. إذا لم يعمل الأمر، جرّب py filename.py.

ما الفرق بين python وpython3 وpy؟

في Windows قد يتوفر python أو py. في كثير من بيئات macOS وLinux يستخدم الأمر python3. استخدم الأمر الذي يعرض لك نسخة Python 3 عند تنفيذ أمر الإصدار.

لماذا لا يظهر زر التشغيل في VS Code؟

تأكد من تثبيت إضافة Python الرسمية داخل VS Code، ومن فتح ملف بامتداد .py، ثم اختر Python Interpreter من قائمة الأوامر.

هل يجب أن أستخدم VS Code لتشغيل Python؟

لا. يمكنك تشغيل ملفات Python من CMD أو Terminal أو أي محرر يوفر طرفية. VS Code مجرد بيئة مريحة تجمع كتابة الكود وتشغيله في مكان واحد.

لماذا يغلق البرنامج بسرعة عند النقر على ملف py؟

لأن Windows قد ينفذ الملف ثم يغلق النافذة فور انتهاء البرنامج. شغله من CMD أو Terminal أو VS Code حتى تبقى المخرجات والأخطاء ظاهرة أمامك.