Python-Kurs / Python unter macOS und Ubuntu einrichten

Unter macOS und Ubuntu beginnen Sie mit der Prüfung von Version und Pfad des Befehls python3 und richten danach eine virtuelle Projektumgebung ein. Trennen Sie Ihre Entwicklungsumgebung vom Python des Betriebssystems, damit Kursübungen keine Systemwerkzeuge verändern.

Den vorhandenen Interpreter identifizieren

Öffnen Sie ein Terminal und führen Sie diese Prüfungen aus. Die erste Zeile zeigt die Version, die zweite den vom Shell-Befehl gefundenen Pfad und die dritte den vom Interpreter gemeldeten Programmpfad:

python3 --version
command -v python3
python3 -c "import sys; print(sys.executable)"

Notieren Sie die Ergebnisse, bevor Sie etwas installieren. Die Beispiele dieses Kurses setzen Python 3.12 oder neuer voraus. Falls python3 fehlt oder eine ältere Version startet, wählen Sie eine für Ihr Betriebssystem unterstützte Entwicklungsinstallation. Ein bereits vorhandenes System-Python ist kein Grund, dessen Dateien oder Verknüpfungen zu ersetzen.

Insbesondere die Verknüpfung /usr/bin/python3 kann zu Betriebssystemwerkzeugen gehören. Ändern Sie deren Ziel nicht einfach auf einen neueren Interpreter. Bei mehreren Installationen verwenden Sie den vollständigen Pfad der gewünschten Entwicklungsinstallation, um die Projektumgebung anzulegen.

Unter macOS das offizielle Installationspaket verwenden

1. Öffnen Sie die offiziellen Python-Downloads für macOS. Prüfen Sie für das ausgewählte Paket die unterstützte macOS-Version und Prozessorarchitektur.
2. Öffnen Sie das heruntergeladene Installationspaket und folgen Sie dessen Schritten. Öffnen Sie nach erfolgreicher Installation ein neues Terminal.
3. Wiederholen Sie die drei Prüfungen aus dem ersten Abschnitt. Wenn noch eine andere Installation ausgewählt wird, verwenden Sie den absoluten Pfad zum gewünschten Python für die nachfolgende Erstellung der virtuellen Umgebung.

Beim offiziellen python.org-Installationspaket gehört auch die Einrichtung der Zertifikate zum Ablauf. Öffnen Sie im passenden Python-Ordner unter /Applications die dort bereitgestellte Datei Install Certificates.command und prüfen Sie die Erfolgsmeldung im Terminal. Der Ordnername richtet sich nach der installierten Version. Die offizielle macOS-Anleitung beschreibt diesen Schritt.

Diese Zertifikatseinrichtung ist keine allgemeine Anweisung für jede macOS-Installationsart. Bei HTTPS-Zertifikatsfehlern prüfen Sie zuerst Installationsweg und Zertifikatskonfiguration. Das Abschalten der Zertifikatsprüfung würde die Prüfung des entfernten Gegenübers verhindern und die Ursache nicht beheben.

Unter Ubuntu die Pakete der Distribution installieren

Die folgenden Befehle verwenden die Ubuntu-Paketverwaltung. apt update aktualisiert die Paketlisten; danach werden Interpreter, Unterstützung für virtuelle Umgebungen und pip installiert. Dafür benötigen Sie die entsprechenden Administrationsrechte. Führen Sie diesen Abschnitt nur unter Ubuntu aus, nicht im macOS-Terminal.

sudo apt update
sudo apt install python3 python3-venv python3-pip
python3 --version

Welche Python-Version diese Pakete bereitstellen, hängt von Ihrer Ubuntu-Version ab. Prüfen Sie die Ausgabe von python3 --version. Liegt sie unter 3.12, benötigen Sie für die Kursbeispiele eine passende unterstützte Ubuntu-Version oder eine getrennte Entwicklungsumgebung mit einem geeigneten Interpreter.

Ubuntu empfiehlt für eine vollständigere Python-Umgebung außerdem das Paket python3-full, das unter anderem die Unterstützung für virtuelle Umgebungen einschließt. Die offizielle Ubuntu-Anleitung zur Python-Einrichtung erläutert die Pakete und die Trennung vom System-Python. Entfernen Sie das vom Betriebssystem verwendete python3-Paket nicht.

Die Meldung externally-managed-environment beim Installieren mit pip bedeutet, dass die betreffende Umgebung von einem externen Paketverwalter verwaltet wird. Installieren Sie Projektpakete in einer virtuellen Umgebung, statt mit sudo pip oder dem Aufheben des Schutzes darüber hinwegzugehen. Die Spezifikation extern verwalteter Umgebungen beschreibt den Zweck dieser Trennung.

Eine Projektumgebung erstellen und die Ausführung prüfen

Wählen Sie für macOS oder Ubuntu einen beschreibbaren Übungsordner. Die folgenden Befehle erzeugen darin einen Projektordner und eine virtuelle Umgebung. Wenn python-lab bereits existiert, verwenden Sie den passenden vorhandenen Ordner bewusst oder wählen Sie einen neuen Namen. Die Umgebung muss mit dem zuvor geprüften Interpreter angelegt werden:

mkdir python-lab
cd python-lab
python3 -m venv .venv
.venv/bin/python --version
.venv/bin/python -m pip --version
.venv/bin/python -c "print(3500 + 8000 + 2500)"

Die letzte Zeile muss 14000 ausgeben. Prüfen Sie bei der pip-Ausgabe, dass der Pfad zur neuen .venv gehört. Ersetzen Sie in der Berechnung nur 8000 durch 9000; erwarten Sie 15000. Stellen Sie danach den Ausgangswert wieder her und bestätigen Sie erneut 14000.

Wenn der gewünschte Interpreter nicht als python3 gefunden wird, ersetzen Sie nur dessen Aufruf bei -m venv durch den zuvor ermittelten absoluten Pfad. Nach der Erstellung verwenden die gezeigten Befehle ausdrücklich .venv/bin/python. Diese Pfade gelten für macOS und Ubuntu; Windows verwendet im Umgebungsordner stattdessen Scripts/python.exe.

Mit source .venv/bin/activate können Sie die Umgebung in einer passenden Shell aktivieren, mit deactivate wieder verlassen. Die Aktivierung passt die Befehlssuche der aktuellen Shell an; der direkte Aufruf von .venv/bin/python benötigt sie nicht. Eine neu geöffnete Shell muss bei Bedarf erneut aktiviert werden.

Schlägt die Erstellung fehl, lesen Sie die Fehlermeldung und prüfen Sie die zum ausgewählten Interpreter passende venv-Unterstützung. Fehlt unter Ubuntu das Modul, installieren Sie das entsprechende Distributionspaket. Prüfen Sie bei einem nicht gefundenen relativen Programmpfad auch den aktuellen Ordner. Speichern Sie Skripte neben .venv, damit das spätere Neuerstellen der Umgebung Ihren Quellcode nicht entfernt.