حل python is not recognized في Windows وإضافة Python إلى PATH | مشكلة وحل 31

إذا كتبت python أو python --version في CMD أو PowerShell وظهرت رسالة 'python' is not recognized as an internal or external command، فابدأ بالتشخيص قبل إعادة تثبيت أي شيء. جرّب py --version ثم where python. إذا كان py يعمل بينما python لا يعمل، فـPython موجود غالبًا والمشكلة في PATH أو App Execution Aliases. وإذا ظهرت رسالة Python was not found أو فتح Microsoft Store، فراجع الـaliases قبل إضافة مسارات عشوائية.

في مشكلة وحل 31 من بايثون العرب سنحل مشكلة python is not recognized في Windows خطوة بخطوة، ونفرّق بين عدم وجود Python، ومشكلة PATH، وMicrosoft Store alias، وحالة عمل py دون python.

أما إذا كان أمر python يعمل لديك بالفعل وتريد فقط معرفة طريقة تشغيل ملفات .py، فراجع دليل تشغيل ملف Python في CMD وTerminal وVS Code.

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

{alertInfo} الخلاصة السريعة: لا تبدأ بتعديل PATH مباشرة. اختبر python --version وpy --version وwhere python. النتيجة تحدد هل تحتاج إصلاح PATH، أم App Execution Aliases، أم تثبيت Python أصلًا.

شكل خطأ python is not recognized في Windows

في Command Prompt قد تظهر الرسالة:

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

وفي PowerShell قد تظهر رسالة قريبة من:

python : The term 'python' is not recognized as the name of a cmdlet,
function, script file, or operable program.

وقد تواجه بدلًا منها:

Python was not found; run without arguments to install from the Microsoft Store...

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

أول 3 أوامر لتشخيص المشكلة

افتح نافذة CMD جديدة ونفّذ:

python --version
py --version
where python

النتيجة	ماذا تعني غالبًا؟	الحل الذي تبدأ به
python --version يعمل	Windows يتعرف على أمر Python.	لا تعدّل PATH. افحص المشكلة الأخرى التي تواجهك.
py يعمل وpython لا يعمل	Python موجود، لكن أمر python لا يصل إلى alias أو PATH الصحيح.	راجع App Execution Aliases ثم PATH.
يفتح Microsoft Store	Windows يستخدم alias مرتبطة بالمتجر بدل المفسر المتوقع.	راجع App Execution Aliases وطريقة تثبيت Python.
لا يعمل python ولا py	قد لا يكون Python أو Python Install Manager مثبتًا بصورة صحيحة.	افحص Installed apps ثم التثبيت الرسمي.
where python يعرض أكثر من مسار	قد توجد نسخ متعددة أو aliases متنافسة.	تحقق من المفسر الفعلي باستخدام sys.executable.

الحالة الأولى: py يعمل لكن python لا يعمل

إذا أعطاك:

py --version

رقم إصدار Python، فلا تتعامل مع المشكلة على أنها «Python غير مثبت». اعرف أولًا المفسر الذي يشغله py:

py -c "import sys; print(sys.executable)"

وإذا كنت تستخدم Python Install Manager الحديث، يمكنك عرض الإصدارات التي يعرفها باستخدام:

py list

إذا كان py يعمل لكن python لا يعمل، انتقل إلى App Execution Aliases وPATH بدل إعادة تثبيت Python مباشرة.

{alertSuccess} عمل py دليل مهم: لديك مفسر Python يمكن الوصول إليه، والمشكلة غالبًا في طريقة الوصول إلى الأمر python.

الحالة الثانية: Python was not found أو فتح Microsoft Store

Windows يستخدم App Execution Aliases لبعض الأوامر. لذلك قد يؤدي الأمر python إلى Microsoft Store بدل تشغيل النسخة التي ثبتها المستخدم.

افتح Start وابحث عن:

Manage app execution aliases

هنا يجب الانتباه إلى طريقة تثبيت Python:

• إذا كنت تستخدم Python Install Manager الحديث، توصي وثائق Python الحالية بأن تكون alias الخاصة بـPython (default) مفعلة. وإذا كانت مفعلة لكن الأمر لا يعمل، جرّب إيقافها ثم تشغيلها مرة أخرى لتحديث التسجيل.
• إذا كنت تستخدم مثبت Python تقليديًا، وكان Windows يفتح Microsoft Store بدل التثبيت الحقيقي، فقد تكون alias القديمة الخاصة بـApp Installer هي التي تسبق مسار Python. في هذه الحالة راجع ترتيب PATH أو عطّل alias المتعارضة.

{alertWarning} لا تتبع نصيحة «عطّل python.exe دائمًا» بشكل آلي. هذا قد يكون مناسبًا لتركيب قديم، لكنه ليس القاعدة الصحيحة مع Python Install Manager الحديث.

الحالة الثالثة: إضافة Python إلى PATH في Windows

إذا كان Python مثبتًا لكن Windows لا يجد الأمر، فالمشكلة قد تكون أن المجلد المطلوب غير موجود في PATH.

لفتح الإعداد:

1. افتح Start.
2. ابحث عن Edit environment variables for your account.
3. افتح Environment Variables.
4. ضمن User variables اختر Path.
5. اضغط Edit ثم New.
6. أضف المسار الصحيح الخاص بتثبيتك.
7. احفظ التغييرات وأغلق نافذة Terminal الحالية.
8. افتح CMD جديدة واختبر python --version.

ما المسار الصحيح الذي أضيفه؟

لا توجد قيمة واحدة تصلح لكل الأجهزة.

مع Python Install Manager، يكون مجلد aliases العالمي افتراضيًا:

%LocalAppData%\Python\bin

كما أن اختصارات التطبيقات في Windows تعتمد عادةً على وجود:

%UserProfile%\AppData\Local\Microsoft\WindowsApps

ضمن PATH.

أما مع التثبيت التقليدي، فأضف المجلد الحقيقي الذي يحتوي على python.exe. قد يكون مسارًا شبيهًا بهذا:

C:\Users\YourName\AppData\Local\Programs\Python\Python3xx\

لكن لا تنسخ هذا المسار حرفيًا. استخدم المسار الموجود على جهازك.

هل أضيف مجلد Scripts إلى PATH؟

تكرر في نتائج البحث اقتراح إضافة مجلد Python ومجلد Scripts معًا. هذا مفيد في التثبيت التقليدي، لكن يجب فهم الفرق:

• المجلد الذي يحتوي python.exe هو المهم لتشغيل الأمر python.
• مجلد Scripts يحتوي عادةً أوامر مثل pip.exe وأوامر الحزم المثبتة.

مثال تقليدي:

C:\Users\YourName\AppData\Local\Programs\Python\Python3xx\
C:\Users\YourName\AppData\Local\Programs\Python\Python3xx\Scripts\

إذا كانت مشكلتك فقط أن python غير معروف، لا تحوّل المقال إلى إصلاح pip. بعد أن يعمل Python يمكنك التحقق من pip باستخدام:

python -m pip --version

الحالة الرابعة: Python غير مثبت أو التثبيت غير مكتمل

إذا لم يعمل python ولا py، افتح:

Settings → Apps → Installed apps

وابحث عن Python أو Python Install Manager.

إذا لم يكن لديك تثبيت صالح، استخدم المصدر الرسمي لتنزيل Python. توصي وثائق CPython الحالية على Windows باستخدام Python Install Manager، الذي يمكن الحصول عليه من Python.org أو Microsoft Store.

بعد التثبيت افتح Terminal جديدة واختبر:

python --version
py --version

إذا نجح py فقط، عد إلى قسمي aliases وPATH بدل إعادة التثبيت مرة أخرى.

هل أعيد تشغيل مثبت Python وأختار Add python.exe to PATH؟

هذا الحل يظهر كثيرًا في نتائج البحث، وهو مفيد خصوصًا مع المثبت التقليدي.

إذا كنت تستخدم تثبيتًا تقليديًا من Python.org وتوجد لديك شاشة Modify أو خيار Add python.exe to PATH، تستطيع استخدام المثبت لإضافة المسارات بدل تعديلها يدويًا.

أما مع Python Install Manager الحديث، فإدارة الأوامر والaliases مختلفة. لذلك افحص طريقة تثبيتك أولًا ولا تعتمد على صور قديمة لمثبت Python على أنها الخطوات الوحيدة الصحيحة.

لماذا يجب فتح CMD جديدة بعد تعديل PATH؟

نافذة Terminal المفتوحة قبل تعديل المتغيرات قد تستمر بالقيم القديمة. بعد تعديل PATH أو aliases:

1. أغلق CMD وPowerShell وTerminal داخل VS Code.
2. افتح نافذة جديدة.
3. جرّب python --version مرة أخرى.

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

كيف أعرف أي Python يعمل فعليًا؟

إذا ظهر لك الإصدار لكن لديك أكثر من نسخة Python، لا تعتمد على رقم الإصدار وحده.

استخدم:

python -c "import sys; print(sys.executable)"

وإذا كان python لا يعمل لكن py يعمل:

py -c "import sys; print(sys.executable)"

كما يمكنك فحص المسارات التي يجدها Windows:

where python

إذا ظهرت أكثر من نتيجة، فقد يكون لديك أكثر من Python أو alias مختلفة. هنا يساعد sys.executable على معرفة المفسر الذي بدأ فعليًا.

ماذا لو python وpy يشغّلان نسختين مختلفتين؟

هذه حالة مهمة عند وجود أكثر من تثبيت.

مع Python Install Manager استخدم:

py list

ثم قارن:

python -c "import sys; print(sys.version)"
python -c "import sys; print(sys.executable)"

إذا كان python يشغّل نسخة غير المتوقعة، راجع ترتيب PATH وApp Execution Aliases والتثبيتات القديمة. لا تضف مسارات جديدة فوق بعضها قبل معرفة أي نسخة تريد الاحتفاظ بها.

ماذا لو المشكلة داخل VS Code فقط؟

إذا فشل python في CMD العادية أيضًا، فالمشكلة على مستوى Windows أو التثبيت أو PATH.

أما إذا كان python يعمل خارج VS Code لكن مشروعك يستخدم مفسرًا مختلفًا، فراجع Python Interpreter داخل VS Code. يمكنك مراجعة: تجهيز بيئة Python وVS Code وvenv خطوة بخطوة.

وإذا كان مشروعك يستخدم بيئة افتراضية، راجع: شرح البيئة الافتراضية venv في Python للمبتدئين.

اختبار نهائي بعد الإصلاح

نفّذ:

python --version
python -c "import sys; print(sys.executable)"
python -c "print('Python works')"

إذا ظهر الإصدار، ثم مسار مفسر Python، ثم:

Python works

فالأمر python أصبح يعمل.

يمكنك بعدها إنشاء main.py:

print("Hello from Python")

وتشغيله:

python main.py

أخطاء شائعة أثناء حل المشكلة

نسخ مسار Python من شرح على الإنترنت

المسار يتغير حسب اسم المستخدم وإصدار Python وطريقة التثبيت. استخدم مسارك الحقيقي.

تعطيل App Execution Aliases دائمًا

هذا الحل منتشر في نتائج البحث القديمة، لكنه ليس صحيحًا لكل طرق التثبيت الحالية. مع Python Install Manager قد تحتاج alias الخاصة بـPython (default) مفعّلة.

إعادة تثبيت Python رغم أن py يعمل

إذا كان py --version يعمل، شخّص PATH والaliases أولًا.

إضافة مسارات كثيرة إلى PATH

هذا قد يجعل Windows يشغّل نسخة مختلفة عن التي تريدها. أضف المسار الذي تحتاجه فقط.

عدم فتح Terminal جديدة

بعد تغيير PATH أو aliases أغلق الطرفية وافتحها من جديد.

Checklist لحل python is not recognized

الاختبار	إذا نجح	إذا فشل
python --version	الأمر يعمل؛ لا تعدّل PATH بلا سبب.	اختبر py --version.
py --version	Python موجود؛ راجع alias وPATH لأمر python.	افحص التثبيت وPython Install Manager.
where python	راجع المسار أو تعدد النتائج.	Windows لا يجد أمر python في PATH.
App Execution Aliases	تأكد أن alias مناسبة لطريقة تثبيتك.	حدّث alias أو أصلح التثبيت.
sys.executable	تأكد أن المسار هو المفسر المطلوب.	راجع تعدد الإصدارات وPATH.

أسئلة شائعة

كيف أحل python is not recognized في CMD؟

ابدأ بـpython --version ثم py --version وwhere python. إذا عمل py فراجع PATH وApp Execution Aliases. وإذا لم يعمل أي أمر، افحص تثبيت Python.

لماذا py يعمل لكن python لا يعمل؟

لأن py يستطيع الوصول إلى Python بينما alias أو PATH الخاصة بأمر python لا تشير إلى المفسر المطلوب. افحص App Execution Aliases وPATH قبل إعادة التثبيت.

كيف أصلح Python was not found ورسالة Microsoft Store؟

راجع Manage app execution aliases. إذا كنت تستخدم Python Install Manager الحديث، تأكد من alias الخاصة بـPython (default). وإذا كنت تستخدم تثبيتًا تقليديًا، افحص هل alias القديمة الخاصة بالمتجر تسبق مسار Python الحقيقي.

كيف أضيف Python إلى PATH في Windows 11؟

افتح Edit environment variables for your account، ثم عدّل User Path وأضف المسار الحقيقي الذي يحتاجه تثبيتك. بعد الحفظ افتح Terminal جديدة واختبر python --version.

هل يجب إضافة Scripts إلى PATH؟

ليس لتشغيل python نفسه بالضرورة. مجلد Scripts مهم عادةً لأوامر مثل pip وأوامر الحزم المثبتة، خصوصًا في التثبيت التقليدي.

كيف أعرف مكان Python على Windows؟

إذا كان الأمر يعمل، استخدم:

python -c "import sys; print(sys.executable)"

ويمكنك أيضًا استخدام where python لمعرفة المسارات التي يجدها Windows.

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

• سلسلة مشكلة وحل في بايثون
• تشغيل ملف Python في CMD وTerminal وVS Code
• تجهيز بيئة Python وVS Code وvenv خطوة بخطوة
• شرح البيئة الافتراضية venv في Python للمبتدئين

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

• Python Documentation — Using Python on Windows
• Python.org — Python Releases for Windows
• Microsoft Learn — Python on Windows for beginners

الخلاصة

خطأ python is not recognized لا يعني تلقائيًا أن Python غير مثبت. نتائج البحث حول المشكلة تدور غالبًا حول ثلاثة أسباب: PATH غير صحيح، App Execution Alias تتدخل في الأمر، أو تثبيت Python غير متاح للطرفية.

ابدأ دائمًا بـpython --version وpy --version وwhere python. إذا عمل py فقط، أصلح الوصول إلى python. وإذا ظهر Microsoft Store، افحص aliases. وإذا لم يعمل أي منهما، افحص التثبيت. وبعد الإصلاح استخدم sys.executable للتأكد أنك تشغّل مفسر Python الصحيح فعلًا.

{alertSuccess} القاعدة الذهبية: شخّص الحالة أولًا ثم أصلح السبب المحدد. لا تضف PATH عشوائيًا، ولا تعطل aliases عشوائيًا، ولا تعِد تثبيت Python قبل أن تعرف أي جزء هو الذي لا يعمل.