Python integreren in Windows 11 PATH: een stapsgewijze handleiding

Als je ooit Python op Windows hebt geprobeerd en de klassieke foutmelding kreeg:

'python' is not recognized as an internal or external command

Ja, je bent niet de enige. Deze frustratie komt naar boven wanneer Windows het uitvoerbare bestand van Python niet kan vinden in het PATH van je systeem – het is in feite alsof je zegt: “Hé, ik heb Python geïnstalleerd, maar ik ben vergeten te vertellen waar het staat.” Het goede nieuws is dat dit meestal vrij eenvoudig op te lossen is, en het betekent dat je Python en pip vanaf elke terminal kunt uitvoeren zonder dat je elke keer het volledige pad naar de map hoeft in te voeren. Dat scheelt een hoop gemoedsrust.

In deze handleiding vind je een handvol solide manieren om Python herkend te krijgen. Of je nu hebt geïnstalleerd via python.org, de Microsoft Store hebt gebruikt of gewoon een fout hebt gemaakt tijdens de installatie, hier is een oplossing die je opdrachtregel blij zal maken. Bovendien bespreken we hoe je kunt controleren of je installatie werkt en hoe je veelvoorkomende fouten kunt vermijden waar mensen over struikelen.

Waarom de ‘python’-opdracht wordt geblokkeerd

Dit gebeurt normaal gesproken omdat Windows naar programma’s zoekt in de PATH-omgevingsvariabele. Als de directory van Python er niet in staat, loopt het typen pythonin je terminal gewoon…vast. Niet gevonden. Dit kan gebeuren als je het vakje om Python aan PATH toe te voegen tijdens de installatie niet hebt aangevinkt, of als er onderweg iets mis is gegaan.

Het is een beetje vreemd, maar Windows wil graag expliciet weten waar programma’s zich bevinden. Om dit op te lossen, moet je dus meestal PATH bijwerken of de Python Launcher (py.exe) gebruiken. Deze ondersteunt meerdere versies beter en je hoeft niet elke keer met omgevingsvariabelen te rommelen.

Hoe je ‘Python niet herkend’ op Windows kunt oplossen

Methode 1 — Gebruik het Python-installatieprogramma om het automatisch aan PATH toe te voegen (beste optie)

Absoluut de makkelijkste. Als je Python hebt geïnstalleerd vanaf python.org, kan het installatieprogramma het zware werk voor je doen, inclusief het toevoegen van Python aan je PATH tijdens de installatie.

• Download het nieuwste installatieprogramma van python.org.
• Voer het installatieprogramma uit. Zorg ervoor dat u bij het openen het vakje ‘Voeg Python 3.x toe aan PATH’ onderaan aanvinkt voordat u op ‘Nu installeren’ klikt. Soms smokkelt Windows dit vakje er stiekem in, dus laat het niet liggen.
• Voltooi de installatie. Sluit het installatieprogramma af zodra de installatie voltooid is.
• Open een nieuwe terminal (Opdrachtprompt of PowerShell) en typ:

python --version pip --version where python where pip 

Als alles goed is ingesteld, zou je je Python-versie en die van pip zonder fouten moeten zien. Bij sommige configuraties herkent de terminal de opdrachten mogelijk niet de eerste keer. Probeer daarom de terminal te sluiten en een nieuwe te openen.

Methode 2 — Python handmatig toevoegen aan uw gebruikers-PATH (geen beheerder nodig)

Dit is het geval als je de PATH-optie niet hebt geselecteerd tijdens de installatie, of als deze op de een of andere manier verloren is gegaan. Je kunt de mappen zelf toevoegen – gewoon een beetje bewerken in de Windows-omgeving. Let op: dit heeft alleen invloed op je gebruikersaccount, niet op alle gebruikers op het systeem. Geen beheerdersrechten nodig, handig.

• Druk op Win + R, typ sysdm.cplen druk op Enter. Hiermee opent u het venster Systeemeigenschappen.
• Ga naar het tabblad Geavanceerd en klik op Omgevingsvariabelen…
• Zoek en selecteer Pad onder Gebruikersvariabelen en klik vervolgens op Bewerken.
• Klik op Nieuw en plak het in uw Python-installatiemap, bijvoorbeeld:

C:\Users\\AppData\Local\Programs\Python\Python311

En vergeet de map Scripts niet, waar pip en andere hulpmiddelen zich bevinden:

C:\Users\\AppData\Local\Programs\Python\Python311\Scripts

• Gebruik indien nodig de knop Omhoog om deze items een hogere prioriteit te geven.
• Klik op OK in alle vensters en start uw terminal opnieuw op.
• Controleer of het lukt met dezelfde opdrachten als hiervoor:

python --version pip --version where python where pip 

Let op: vermijd veelvoorkomende fouten, zoals het onnodig toevoegen van een afsluitende backslash ( …\Python311oké, …\Python311\nee), en controleer nogmaals of er geen ongeldige paden in je PATH-variabele staan. Windows kan meedogenloos zijn als je onjuiste gegevens laat staan.

Methode 3 — Microsoft Store Python-installaties verwerken met app-aliassen

Als je Python uit de Microsoft Store hebt gehaald, is het vaak afhankelijk van App Execution Aliases. Dit zijn een soort snelkoppelingen die het besturingssysteem instelt, maar ze kunnen soms in de weg zitten of conflicteren met je PATH.

• Open Windows-instellingen en zoek naar App-uitvoeringsaliassen beheren.
• Zoek naar items voor python.exeen python3.exe. Schakel deze indien nodig uit of in – soms pythonveroorzaken ze vreemde situaties als je op de Store klikt om deze te openen.
• Zorg er daarnaast voor dat uw gebruikers-PATH het volgende bevat:

C:\Users\\AppData\Local\Microsoft\WindowsApps

Zodra dit is ingesteld, start u uw terminal opnieuw op en probeert u het opnieuw met python --version. Directe herkenning indien correct geplaatst. Soms werkt dit alleen na een herstart of na uit- en inloggen.

Methode 4: Gebruik de Python Launcher (het beste voor meerdere Python-versies)

De Python Launcher (py.exe) wordt automatisch geïnstalleerd wanneer je installeert vanaf python.org. Het helpt je om verschillende Python-versies te draaien zonder dat je steeds met het PATH hoeft te rommelen. Als je met meerdere Python-versies werkt, is dit een uitkomst.

• Controleer of je het kunt bellen:

py --version 

Als dat een versie oplevert, prima. Je kunt dan specifieke Python-versies uitvoeren, zoals:

py -3 py -3.11 py -2.7 

Wilt u een virtuele omgeving creëren? Eenvoudig:

py -3.11 -m venv myenv myenv\Scripts\activate python --version 

Bonustip: gebruik deze tool py --listom alle gedetecteerde Python-runtimes te bekijken. Perfect voor het beheren van meerdere projecten zonder telkens je PATH te hoeven bewerken. Meer informatie vind je in de officiële Python-documentatie.

Snelle tips voor probleemoplossing

Nog steeds niets? Voer deze opdrachten uit om het te controleren:

where python where python3 where py 

En controleer ook pip:

pip --version where pip 

Als Python de Microsoft Store opent in plaats van je lokale installatie, ligt het waarschijnlijk aan de app-aliasinstelling. Schakel deze uit via Instellingen → Apps → Apps en onderdelen → Apps en onderdelen → App-uitvoeringsaliassen beheren.

En probeer natuurlijk je terminal volledig te sluiten en opnieuw te openen na het aanbrengen van wijzigingen. Soms heeft Windows gewoon een frisse start nodig om nieuwe omgevingsvariabelen te herkennen.

Afronding

De meeste “Python wordt niet herkend”-fouten komen neer op verkeerde PATH-configuraties of problemen met app-aliassen. Het aanvinken van het PATH-vakje in het installatieprogramma, het handmatig bewerken van omgevingsvariabelen of het aan-/uitzetten van die app-snelkoppelingen is meestal voldoende. Het belangrijkste is dat Windows precies weet waar Python te vinden is.

Zodra alles is ingesteld, wordt het werken met de opdrachtregel een stuk eenvoudiger: u hoeft geen lange paden meer te typen of Python voor de derde keer opnieuw te installeren.