تشغيل ملف Python من CMD وPowerShell وVS Code على Windows

إذا كان Python مثبتًا على Windows ولديك ملف ينتهي بالامتداد .py، فهذه الصفحة تشرح تشغيل الملف محليًا من CMD وPowerShell وVS Code. الأوامر الأساسية هي python file.py أو py file.py، لكن نجاحها يعتمد على وجودك داخل مجلد الملف واختيار مفسر Python الصحيح.

لن نشرح هنا تشغيل Python من المتصفح أو خطوات التثبيت من البداية. إذا كنت تريد التجربة بدون تثبيت، راجع تشغيل بايثون أونلاين بدون تثبيت. وإذا لم يكن Python مثبتًا لديك أصلًا، ابدأ من تحميل وتثبيت Python على Windows ثم عد إلى هذا الدليل.

{alertInfo} الخلاصة السريعة: افتح CMD أو PowerShell داخل المجلد الذي يحتوي على الملف، وتأكد أن dir يعرض اسم الملف، ثم نفّذ python hello.py. إذا لم يعمل أمر python لكن py متاح، استخدم py hello.py. داخل VS Code اختر Python Interpreter الصحيح ثم استخدم Run Python File in Terminal.

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

قبل تشغيل ملف Python على Windows: افحص ثلاثة أشياء

هذا الدليل يفترض أن Python مثبت بالفعل. قبل تشغيل الملف، تأكد فقط من الأمر المتاح، واسم الملف، والمجلد الحالي.

1. تأكد أن Python يعمل من الطرفية

python --version

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

py --version

إذا ظهر إصدار Python 3، فالأمر جاهز. في Windows الحديث قد يتوفر python أو py أو كلاهما حسب طريقة تثبيت Python وإعداد الجهاز.

2. تأكد أن الملف ينتهي فعلًا بـ .py

استخدم اسمًا واضحًا مثل:

hello.py

وليس:

hello.py.txt

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

3. اعرف المجلد الذي يحتوي على الملف

أكثر أخطاء التشغيل شيوعًا لا تكون في الكود نفسه، بل في أن الطرفية مفتوحة داخل مجلد مختلف. سنستخدم ملفًا باسم hello.py داخل مجلد python-demo في الأمثلة التالية.

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

افتح Command Prompt، ثم انتقل إلى مجلد الملف باستخدام cd. إذا كان المشروع على سطح المكتب:

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

استخدم علامات الاقتباس عندما يحتوي المسار على مسافات. وبعد الانتقال إلى المجلد اكتب:

dir

يجب أن ترى hello.py ضمن الملفات. بعدها شغّله:

python hello.py

أو إذا كان أمر py هو المتاح لديك:

py hello.py

إذا كان الملف في مجلد آخر ولا تريد الانتقال إليه أولًا، يمكنك تمرير المسار الكامل:

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

كيف تشغّل ملف Python من PowerShell؟

PowerShell يعمل بالفكرة نفسها: انتقل إلى مجلد الملف ثم شغّل السكربت بواسطة مفسر Python.

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

وإذا كنت تستخدم py:

py .\hello.py

يمكنك أيضًا استخدام Set-Location بدل cd:

Set-Location "C:\Users\YourName\Desktop\python-demo"

إذا ظهرت رسالة في PowerShell مثل The term 'python' is not recognized... فالمشكلة في العثور على مفسر Python، وليست في ملف .py نفسه. انتقل إلى قسم python is not recognized في هذه الصفحة.

المجلد الحالي Working Directory: لماذا يعمل الأمر أحيانًا ويفشل أحيانًا؟

عندما تكتب:

python hello.py

فإن Python يبحث عن hello.py بالنسبة إلى المجلد الحالي للطرفية. لذلك افحص المجلد أولًا:

في CMD

cd
dir

في PowerShell

Get-Location
Get-ChildItem

إذا لم يظهر الملف في القائمة، إمّا أن تنتقل إلى مجلده باستخدام cd أو تشغله عبر المسار الكامل.

كيف تشغّل ملف Python في VS Code على Windows؟

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

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

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

Run > Python File in Terminal

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

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

افتح:

Terminal > New Terminal

ثم افحص المجلد الحالي واسم الملف، وبعدها نفّذ:

python hello.py

أو:

py hello.py

هذه الطريقة مفيدة عندما تريد رؤية الأمر كاملًا، أو تشغيل أكثر من ملف، أو تمرير arguments إلى البرنامج.

كيف تمرّر arguments إلى ملف Python من CMD أو PowerShell؟

كل ما تكتبه بعد اسم الملف يُمرر إلى السكربت كـcommand-line arguments. مثلًا:

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

أو باستخدام py:

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

ولرؤية القيم داخل Python يمكنك استخدام sys.argv:

import sys

print(sys.argv)

عند تشغيل:

python main.py report 2026

ستحصل على قائمة قريبة من:

['main.py', 'report', '2026']

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

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

إذا كتبت:

python hello.py

وظهرت رسالة من CMD مثل:

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

أو ظهرت رسالة مشابهة في PowerShell، فهذا يعني أن الطرفية لا تستطيع الوصول إلى أمر python.

1. جرّب الأمر py

py --version
py hello.py

لا تفترض أن py موجود في كل جهاز؛ طريقة تثبيت Python تحدد الأوامر المتاحة.

2. اعرف ما الذي يراه Windows

في CMD:

where python
where py

وفي PowerShell:

Get-Command python
Get-Command py

3. إذا لم يعمل python ولا py

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

في إصدارات Python الحديثة على Windows توصي وثائق Python باستخدام python لتشغيل البيئة الافتراضية أو الإصدار الافتراضي، بينما يكون py مفيدًا أيضًا عند التعامل مع أكثر من runtime. المهم في هذا المقال هو استخدام الأمر الذي يعمل فعلًا على جهازك.

حل python: can't open file وNo such file or directory

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

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

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

• هل يظهر hello.py عند تنفيذ dir؟
• هل اسم الملف مكتوب بالحروف والامتداد الصحيحين؟
• هل الملف هو .py فعلًا وليس .py.txt؟
• هل المسار يحتوي على مسافات ويحتاج إلى علامات اقتباس؟

يمكنك تجاوز مشكلة المجلد الحالي باستخدام المسار الكامل:

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

ModuleNotFoundError بعد أن يبدأ الملف في العمل

إذا بدأ Python تشغيل الملف ثم ظهر:

ModuleNotFoundError: No module named 'requests'

فهذا مختلف عن مشكلة تشغيل ملف .py. هنا المفسر يعمل، لكن المكتبة غير مثبتة في البيئة الحالية. استخدم المفسر نفسه مع pip:

python -m pip install requests

وراجع دليل pip وتثبيت مكتبات Python إذا كانت المشكلة في الحزم أو البيئات.

مثال عملي كامل على Windows

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

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

result = first_number + second_number

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

من CMD أو PowerShell داخل المجلد نفسه:

python calculator.py

أو:

py calculator.py

وفي VS Code يمكنك تشغيل الملف باستخدام Run Python File in Terminal بعد اختيار Interpreter الصحيح.

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

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

{alertSuccess} قاعدة عملية: إذا لم يعمل ملف .py، افحص بهذا الترتيب: الأمر python أو py، ثم المجلد الحالي، ثم اسم الملف، ثم Interpreter في VS Code، وبعدها فقط انتقل إلى أخطاء الكود أو المكتبات.

الخلاصة

• لتشغيل ملف Python من CMD استخدم python file.py أو py file.py بعد الانتقال إلى مجلد الملف.
• في PowerShell يمكنك استخدام الأوامر نفسها، مثل python .\file.py.
• في VS Code اختر Python Interpreter الصحيح ثم استخدم Run Python File in Terminal.
• إذا ظهر python is not recognized، افحص python وpy باستخدام where أو Get-Command.
• إذا ظهر can't open file، افحص المجلد الحالي واسم الملف أو استخدم المسار الكامل.
• لتمرير arguments، أضفها بعد اسم الملف مثل python main.py report 2026.

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

• Using Python on Windows — Python Documentation
• Running Python code in Visual Studio Code
• Python on Windows — Microsoft Learn

أسئلة شائعة

كيف أشغّل ملف Python من CMD على Windows؟

انتقل إلى مجلد الملف باستخدام cd، وتأكد من ظهوره عبر dir، ثم نفّذ python filename.py أو py filename.py.

كيف أشغّل ملف Python من PowerShell؟

انتقل إلى مجلد الملف باستخدام cd أو Set-Location، ثم استخدم python .\filename.py أو py .\filename.py.

كيف أشغّل ملف Python في VS Code؟

افتح مجلد المشروع، اختر المفسر من Python: Select Interpreter، ثم اضغط Run Python File in Terminal.

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

كلاهما قد يشغّل ملف Python على Windows، لكن توفر كل أمر وسلوكه يعتمد على طريقة تثبيت Python. استخدم python --version وpy --version لمعرفة الأمر المتاح لديك.

لماذا تظهر رسالة python is not recognized؟

لأن Windows أو الطرفية لا تستطيع الوصول إلى أمر python. جرّب py، ثم افحص الأوامر باستخدام where أو Get-Command. إذا لم يعمل أي منهما، راجع تثبيت Python وإعدادات النظام.

لماذا يظهر python: can't open file؟

غالبًا لأن الطرفية ليست داخل مجلد الملف أو لأن اسم الملف أو المسار غير صحيح. نفّذ dir وتحقق من الاسم، أو مرر المسار الكامل للملف.

كيف أمرّر arguments إلى ملف Python؟

أضف القيم بعد اسم الملف، مثل python main.py report 2026. تصل هذه القيم إلى البرنامج عبر sys.argv أو أدوات CLI مثل argparse.