Python-versie controleren: Windows, macOS en Linux

Weten welke Python-versie je gebruikt, is belangrijker dan je misschien denkt. Veel libraries en frameworks zijn afhankelijk van specifieke Python-versies, en code kan zich anders gedragen per release. Scripts draaien op een niet-ondersteunde of onverwachte versie leidt vaak tot installatiefouten of runtime-fouten die lastig te achterhalen zijn.

In deze gids laat ik je eenvoudige en betrouwbare manieren zien om je Python-versie te controleren op gangbare besturingssystemen, in verschillende omgevingen en setups. Als je net begint met Python, raad ik onze Introduction to Python-cursus aan, die onderwerpen behandelt als datatypes, lijsten, basisfuncties en pakketten.

Python-versie controleren via de command line

De meest gebruikte manier om je Python-versie te controleren is via de terminal van je computer (Mac/Linux) of Command Prompt/PowerShell (Windows).

Met python --version

Deze opdracht vraagt het systeem welke Python-interpreter is gekoppeld aan het python-commando en print de versie.

python --version

Dit werkt op de meeste systemen als python correct in je PATH staat. Het commando kan echter falen als python naar Python 2 verwijst of niet in de PATH staat.

Met python3 --version

Op sommige systemen, vooral macOS en Linux, moet je python3 gebruiken om expliciet naar Python 3 te verwijzen. Dit komt doordat de meeste moderne computers zowel Python 2 als Python 3 hebben geïnstalleerd.

python3 --version

Op Windows werkt dit commando mogelijk niet, tenzij Python is geïnstalleerd met python3 expliciet toegevoegd.

Met python -V (alternatieve syntaxis)

Dit commando is een verkorte versie van python --version.

python -V

Het levert dezelfde output op, maar gedraagt zich in sommige omgevingen net iets anders. In oudere omgevingen of bepaalde shells kan het versienummer naar stderr (standard error) worden gestuurd in plaats van naar stdout (standard output).

Voor het oog lijkt het hetzelfde op het scherm, maar in scripts kan het uitmaken als je die tekst wilt “pijpen” naar een ander bestand of programma.

Python-versie binnen Python controleren

Soms wil je de Python-versie controleren vanuit een script of een interactieve sessie. Dit is handig wanneer je code zijn runtime-omgeving moet bevestigen om te helpen bij het debuggen van problemen in je script.

Je kunt versiegegevens opvragen door de ingebouwde bibliotheek sys te importeren. De onderstaande code toont de volledige Python-versiestring met build-gegevens.

-- Check Python version
import sys
print(sys.version)

Deze methode is handig bij het schrijven van conditionele logica die afhankelijk is van de Python-versie en bij het loggen van runtime-informatie.

Python-versie controleren in virtuele omgevingen

Omdat virtuele omgevingen (venv en conda) per project worden gebruikt, kunnen ze een andere Python-versie gebruiken dan de standaard Python van je systeem. Als je een virtuele omgeving maakt, wordt die geleverd met een specifieke Python-interpreter en door de omgeving te activeren, wissel je welke Python-uitvoerbare wordt gebruikt.

Om de actieve Python-versie in je virtuele omgeving te bevestigen, activeer je die eerst en voer je vervolgens het volgende commando uit:

python --version

Als de getoonde versie niet is wat je verwacht, is de omgeving mogelijk gemaakt met een andere Python-installatie of is deze nu niet geactiveerd.

Ik raad onze Conda Cheat Sheet aan als je in één oogopslag pakketten wilt beheren en met de conda-omgeving wilt werken.

Python-versie controleren op verschillende besturingssystemen

Elk besturingssysteem gaat net iets anders met Python om. Zo controleer je de Python-versie per systeem:

Windows

Om de Python-versie in Windows te controleren, kun je gebruiken:

python --version

Of:

py --version

De nadelen van deze methode zijn dat meerdere Python-installaties voor verwarring kunnen zorgen, of dat python niet wordt herkend door een verkeerde PATH-configuratie. Ook kan de py-launcher naar een andere versie verwijzen dan python, en zo falen.

macOS en Linux

Op macOS en Linux moet je weten dat het systeem een vooraf geïnstalleerde Python kan bevatten die intern door het OS wordt gebruikt. Ook kan python naar Python 2 verwijzen of helemaal niet bestaan, terwijl python3 meestal naar de door de gebruiker geïnstalleerde Python 3-versie wijst.

Je kunt de Python-versie in macOS of Linux controleren met:

python --version

Of gebruik python3 om te voorkomen dat je per ongeluk een verouderde of door het systeem beheerde Python gebruikt.

python3 --version

Veelvoorkomende problemen bij het controleren van de Python-versie

Bij het controleren van de Python-versie kun je in de war raken, vooral wanneer meerdere tools en omgevingen betrokken zijn:

• “Python command not found”: Dit betekent meestal dat Python niet is geïnstalleerd of niet aan je systeem-PATH is toegevoegd. Op sommige systemen is alleen python3 beschikbaar, niet python.

• Meerdere Python-versies geïnstalleerd: Het is gebruikelijk om meer dan één Python-versie op dezelfde machine te hebben. Verschillende commando’s zoals python, python3 en py kunnen naar verschillende interpreters verwijzen, waardoor versiecontroles inconsistent lijken.

• Commando geeft een onverwachte versie terug: Mogelijk controleer je een andere Python-installatie dan je bedoelde. Dit gebeurt vaak als een virtuele omgeving niet is geactiveerd of wanneer de PATH-volgorde een andere Python-uitvoerbare prioriteit geeft.

• Versie in IDE komt niet overeen met terminal: Je IDE, zoals VS Code of PyCharm, kan zijn geconfigureerd om een andere Python-interpreter te gebruiken dan je terminal. Code die in de IDE draait, gebruikt de daar ingestelde interpreter en is niet per se dezelfde als die van python --version op de command line.

Best practices voor het beheren van Python-versies

Om verrassingen rond versies te voorkomen, raad ik de onderstaande checklist aan:

• Controleer altijd de Python-versie vóór je afhankelijkheden installeert: Draai altijd python --version voordat je een commando zoals pip install uitvoert. Zo voorkom je dat je per ongeluk libraries in de verkeerde versie installeert.

• Wees expliciet met commando’s: Als je weet dat je Python 3 nodig hebt, gebruik dan python3 in plaats van aan te nemen dat python naar de juiste versie verwijst.

• Gebruik consequent virtuele omgevingen: Gebruik voor elk nieuw project een virtuele omgeving (venv). Zo blijven de versie en libraries van je project gescheiden van de rest van je systeem en weet je zeker dat elk project de juiste Python-versie en dependencies gebruikt.

• Verlaat je niet op de systeem-Python voor projecten: De door het OS beheerde Python wordt vaak door het systeem gebruikt en kun je beter met rust laten. Installeer altijd je eigen Python-versie voor je projecten om de beoogde resultaten te krijgen.

Conclusie

Expliciet zijn over welke Python-versie je draait, helpt om veelvoorkomende setup-problemen te voorkomen, verwarring te verminderen en tijd te besparen bij het installeren van pakketten of het debuggen van fouten.

Voor een grondig begrip van Python kun je meer leren in onze Python Data Fundamentals- en Python Programming Fundamentals-skill tracks. Tot slot raad ik persoonlijk onze Python Developer-carrièrepad aan om te leren over het testen van code en versiebeheer bij web scraping en het ontwikkelen van pakketten.