“'python' is not recognized as an internal or external command” apare atunci când Windows nu poate găsi executabilul Python pe PATH. Adăugarea directoarelor potrivite – sau folosirea lansatorului Python – vă permite să rulați Python și pip de pe orice terminal fără căi complete.
Referință: Îndrumările oficiale despre PATH, opțiunea de instalare și Python Launcher se află în documentele Python sub „Utilizarea Python pe Windows”. Consultați documentația Python Software Foundation la docs.python.org.
Ce vei avea nevoie
- Windows 11 cu o instalare Python (de pe python.org sau Microsoft Store).
- Drepturi de administrator numai dacă se modifică variabile la nivelul întregului sistem; modificările la nivel de utilizator nu necesită administrator.
- O nouă sesiune de terminal după orice modificare a PATH.
Metoda 1 - Utilizați programul de instalare oficial pentru a adăuga PATH (recomandat)
De ce funcționează:Programul de instalare python.org poate seta PATH pentru dvs., evită greșelile de tipar obișnuite și, de asemenea, adaugă folderul Scripts pe care îl folosește pip. Același program de instalare poate „Modifica” o instalare existentă pentru a adăuga PATH mai târziu. Documentele Python notează opțiunea „Adăugați Python la PATH” pe prima pagină de instalare și permit comutarea acesteia după instalare.
Pasul 1:Rulați programul de instalare Python de pe python.org.
Pasul 2:Faceți clic pe Instalați acum sau pe Personalizați instalarea dacă instalați proaspăt.
Pasul 3:Bifați Adăugați python.exe la PATH pe prima pagină.
Pasul 4:Finalizați instalarea.
Pasul 5:Închideți și redeschideți Command Prompt sau PowerShell.
Pasul 6:Verificați că Python și pip sunt disponibile.
python --version
pip --version
where python
where pip
Tip:Dacă Python este deja instalat, rulați din nou programul de instalare, alegeți Modificare, activați Adăugați python.exe la PATH, apoi terminați și redeschideți terminalul. Pentru mai multe despre comportamentul instalatorului și PATH, consultați documentele Python la docs.python.org (legat mai sus).
Metoda 2 - Adăugați manual Python la PATH (la nivel de utilizator)
Când să utilizați:Dacă ați instalat Python fără a activa PATH sau aliniați o instalare existentă. Această metodă vizează PATH-ul utilizatorului, evitând modificări la nivel de sistem.
Pasul 1:PresaWin+R, tastațisysdm.cpl, și apăsațiEnter.
Pasul 2:Selectați fila Avansat și faceți clic pe Variabile de mediu....
Pasul 3:Sub Variabile utilizator, selectați Cale și faceți clic pe Editare.
Pasul 4:Faceți clic pe Nou și adăugați directorul de instalare Python (de exemplu:C:Users<you>AppDataLocalProgramsPythonPython311).
Pasul 5:Faceți clic pe Nou și adăugați directorul Scripts (de exemplu:C:Users<you>AppDataLocalProgramsPythonPython311Scripts).
Pasul 6:Utilizați Mutare în sus pentru a plasa aceste intrări în partea de sus, astfel încât acest Python să fie găsit primul.
Pasul 7:Faceți clic pe OK în toate casetele de dialog pentru a salva modificările.
Pasul 8:Închideți și redeschideți Command Prompt sau PowerShell.
Pasul 9:Verificați că comenzile se rezolvă la căile dvs.
python --version
pip --version
where python
where pip
Note și capcane:
- Evitați să introduceți barele oblice inverse în intrări (utilizați
C:PathToPython311, nuC:PathToPython311). - Nu introduceți spații de început; fiecare intrare ar trebui să fie o linie de cale curată.
- Asigurați-vă că intrările PATH anterioare nu trimit către foldere inexistente; directoarele invalide pot cauza un comportament de rezoluție confuz.
- Reporniți shell-ul după modificări; unele setări necesită deconectare/conectare.
Metoda 3 — Remediați instalările Microsoft Store cu aliasuri de execuție a aplicației
Când să utilizați:Dacă Python a fost instalat prin Microsoft Store. Python bazat pe magazin se bazează pe „aliasele de execuție a aplicației” și pe directorul WindowsApps, mai degrabă decât pe editările PATH tradiționale.
Pasul 1:Deschideți Setări Windows și căutați Gestionare aliasuri de execuție a aplicației.
Pasul 2:Activați comutatoarele pentru versiunea Python prin care doriți să o lansațipython.exeşipython3.exe, sau dezactivați-le pentru a evita conflictele cu o instalare python.org.
Pasul 3:Asigurați-vă că PATH utilizatorului include WindowsApps, astfel încât aliasul să se rezolve:C:Users<you>AppDataLocalMicrosoftWindowsApps.
Pasul 4:Redeschideți terminalul și confirmați că comenzile folosesc aliasul ales.
python --version
python3 --version
where python
Tip:Dacă aliasul lansează Magazinul în loc de Python, dezactivează aliasul pentru acea comandă și bazează-te pe instalarea ta python.org sau folosește Python Launcher (py) descrise mai jos.
Metoda 4 — Folosiți Python Launcher în loc să editați PATH
De ce să luați în considerare acest lucru:Lansatorul Python (py.exe) este instalat cu build-uri python.org și localizează corect versiunile instalate după etichetă, evitând conflictele PATH. Documentele oficiale subliniază selecția versiunii și comportamentul de descoperire a Lansatorului.
Pasul 1:Verificați versiunea de lansare.
py --version
Pasul 2:Rulați versiunea Python dorită în mod explicit.
py -3
py -3.11
py -3.10 -m pip --version
Pasul 3:Creați și utilizați medii virtuale cu lansatorul.
py -3.11 -m venv venv
venvScriptsactivate
python --version
Note:Puteți lista timpii de execuție detectați cupy --listși fixează versiunile pe proiect fără a atinge PATH. Detaliile sunt acoperite în documentele Python sub „Python Launcher pentru Windows” la docs.python.org (linkat o dată mai sus).
Verificare rapidă și depanare
Pasul 1:Confirmați ce executabil rulează.
where python
where python3
where py
Pasul 2:Validați pip și Scripturi.
pip --version
where pip
Pasul 3:Dacăpythondeschide Microsoft Store, dezactivează aliasul de execuție a aplicației corespunzător sau te bazezi pepypentru a lansa versiunea dorită.
Pasul 4:Dacă modificările nu se aplică, închideți complet terminalele și IDE-urile GUI sau deconectați-vă și reconectați-vă, astfel încât mediul actualizat să fie încărcat.
Odată ce PATH este setat (sau Lansatorul este în uz), puteți rula Python și pip oriunde și evitați căile complete. Pentru setările cu mai multe versiuni, preferați lansatorul Python pentru a alege versiunile exacte în mod fiabil și pentru a păstra proiectele izolate cu medii virtuale.
