Wenn Sie an Python-Projekten arbeiten, sollten Sie wahrscheinlich eine **virtuelle Umgebung** (oder einen ähnlichen Mechanismus) verwenden, um die Pakete (englisch: Packages), die Sie für jedes Projekt installieren, zu isolieren.
@ -26,7 +26,7 @@ Wenn Sie bereit sind, ein **Tool zu verwenden, das alles für Sie verwaltet** (e
///
## Ein Projekt erstellen
## Ein Projekt erstellen { #create-a-project }
Erstellen Sie zuerst ein Verzeichnis für Ihr Projekt.
@ -51,7 +51,7 @@ $ cd awesome-project
</div>
## Eine virtuelle Umgebung erstellen
## Eine virtuelle Umgebung erstellen { #create-a-virtual-environment }
Wenn Sie zum **ersten Mal** an einem Python-Projekt arbeiten, erstellen Sie eine virtuelle Umgebung **<abbrtitle="Es gibt andere Optionen, dies ist eine einfache Richtlinie">innerhalb Ihres Projekts</abbr>**.
@ -114,7 +114,7 @@ Sie könnten die virtuelle Umgebung in einem anderen Verzeichnis erstellen, aber
///
## Die virtuelle Umgebung aktivieren
## Die virtuelle Umgebung aktivieren { #activate-the-virtual-environment }
Aktivieren Sie die neue virtuelle Umgebung, damit jeder Python-Befehl, den Sie ausführen oder jedes Paket, das Sie installieren, diese Umgebung verwendet.
@ -170,7 +170,7 @@ So stellen Sie sicher, dass, wenn Sie ein **Terminalprogramm (<abbr title="Comma
///
## Überprüfen, ob die virtuelle Umgebung aktiv ist
## Überprüfen, ob die virtuelle Umgebung aktiv ist { #check-the-virtual-environment-is-active }
Überprüfen Sie, dass die virtuelle Umgebung aktiv ist (der vorherige Befehl funktioniert hat).
@ -212,7 +212,7 @@ Wenn es das `python`-Binary in `.venv\Scripts\python` anzeigt, innerhalb Ihres P
Wenn Sie **Git** verwenden (was Sie sollten), fügen Sie eine `.gitignore`-Datei hinzu, um alles in Ihrem `.venv` von Git auszuschließen.
@ -282,7 +282,7 @@ Dieser Befehl erstellt eine Datei `.gitignore` mit dem Inhalt:
///
## Pakete installieren
## Pakete installieren { #install-packages }
Nachdem Sie die Umgebung aktiviert haben, können Sie Pakete darin installieren.
@ -294,7 +294,7 @@ Wenn Sie eine Version aktualisieren oder ein neues Paket hinzufügen müssen, w
///
### Pakete direkt installieren
### Pakete direkt installieren { #install-packages-directly }
Wenn Sie es eilig haben und keine Datei verwenden möchten, um die Paketanforderungen Ihres Projekts zu deklarieren, können Sie sie direkt installieren.
### Installation von `requirements.txt` { #install-from-requirements-txt }
Wenn Sie eine `requirements.txt` haben, können Sie diese nun verwenden, um deren Pakete zu installieren.
@ -376,7 +376,7 @@ pydantic==2.8.0
///
## Ihr Programm ausführen
## Ihr Programm ausführen { #run-your-program }
Nachdem Sie die virtuelle Umgebung aktiviert haben, können Sie Ihr Programm ausführen, und es wird das Python innerhalb Ihrer virtuellen Umgebung mit den Paketen verwenden, die Sie dort installiert haben.
@ -390,7 +390,7 @@ Hello World
</div>
## Ihren Editor konfigurieren
## Ihren Editor konfigurieren { #configure-your-editor }
Sie würden wahrscheinlich einen Editor verwenden, stellen Sie sicher, dass Sie ihn so konfigurieren, dass er die gleiche virtuelle Umgebung verwendet, die Sie erstellt haben (er wird sie wahrscheinlich automatisch erkennen), sodass Sie Autovervollständigungen und Inline-Fehler erhalten können.
@ -405,7 +405,7 @@ Normalerweise müssen Sie dies nur **einmal** tun, wenn Sie die virtuelle Umgebu
///
## Die virtuelle Umgebung deaktivieren
## Die virtuelle Umgebung deaktivieren { #deactivate-the-virtual-environment }
Sobald Sie mit der Arbeit an Ihrem Projekt fertig sind, können Sie die virtuelle Umgebung **deaktivieren**.
@ -419,7 +419,7 @@ $ deactivate
Auf diese Weise, wenn Sie `python` ausführen, wird nicht versucht, es aus dieser virtuellen Umgebung mit den dort installierten Paketen auszuführen.
## Bereit zu arbeiten
## Bereit zu arbeiten { #ready-to-work }
Jetzt sind Sie bereit, mit Ihrem Projekt zu arbeiten.
Um mit FastAPI zu arbeiten, müssen Sie <ahref="https://www.python.org/"class="external-link"target="_blank">Python</a> installieren.
@ -441,7 +441,7 @@ Um Pakete zu installieren, würden Sie normalerweise den `pip`-Befehl verwenden,
Wenn Sie jedoch `pip` direkt verwenden, werden die Pakete in Ihrer **globalen Python-Umgebung** (der globalen Installation von Python) installiert.
### Das Problem
### Das Problem { #the-problem }
Was ist also das Problem beim Installieren von Paketen in der globalen Python-Umgebung?
@ -524,7 +524,7 @@ Stellen Sie sich das jetzt mit **vielen** anderen **Paketen** vor, von denen all
Darüber hinaus könnte es je nach Ihrem Betriebssystem (z.B. Linux, Windows, macOS) bereits mit installiertem Python geliefert worden sein. Und in diesem Fall hatte es wahrscheinlich einige Pakete mit bestimmten Versionen **installiert**, die von Ihrem System benötigt werden. Wenn Sie Pakete in der globalen Python-Umgebung installieren, könnten Sie einige der Programme, die mit Ihrem Betriebssystem geliefert wurden, **kaputtmachen**.
## Wo werden Pakete installiert
## Wo werden Pakete installiert { #where-are-packages-installed }
Wenn Sie Python installieren, werden einige Verzeichnisse mit einigen Dateien auf Ihrem Rechner erstellt.
@ -550,7 +550,7 @@ Dann wird es all diese Dateien **extrahieren** und sie in ein Verzeichnis auf Ih
Standardmäßig werden diese heruntergeladenen und extrahierten Dateien in das Verzeichnis gelegt, das mit Ihrer Python-Installation kommt, das ist die **globale Umgebung**.
## Was sind virtuelle Umgebungen
## Was sind virtuelle Umgebungen { #what-are-virtual-environments }
Die Lösung für die Probleme, alle Pakete in der globalen Umgebung zu haben, besteht darin, eine **virtuelle Umgebung für jedes Projekt** zu verwenden, an dem Sie arbeiten.
@ -575,7 +575,7 @@ flowchart TB
stone-project ~~~ azkaban-project
```
## Was bedeutet das Aktivieren einer virtuellen Umgebung
## Was bedeutet das Aktivieren einer virtuellen Umgebung { #what-does-activating-a-virtual-environment-mean }
Wenn Sie eine virtuelle Umgebung aktivieren, zum Beispiel mit:
@ -712,7 +712,7 @@ Ein wichtiger Punkt ist, dass es den Pfad der virtuellen Umgebung am **Anfang**
Das Aktivieren einer virtuellen Umgebung ändert auch ein paar andere Dinge, aber dies ist eines der wichtigsten Dinge, die es tut.
## Überprüfen einer virtuellen Umgebung
## Überprüfen einer virtuellen Umgebung { #checking-a-virtual-environment }
Wenn Sie überprüfen, ob eine virtuelle Umgebung aktiv ist, zum Beispiel mit:
@ -764,7 +764,7 @@ Es ist nützlich, überprüfen zu können, welches `python` verwendet wird. 🤓
///
## Warum eine virtuelle Umgebung deaktivieren
## Warum eine virtuelle Umgebung deaktivieren { #why-deactivate-a-virtual-environment }
Zum Beispiel könnten Sie an einem Projekt `philosophers-stone` arbeiten, diese virtuelle Umgebung **aktivieren**, Pakete installieren und mit dieser Umgebung arbeiten.
@ -818,7 +818,7 @@ I solemnly swear 🐺
</div>
## Alternativen
## Alternativen { #alternatives }
Dies ist ein einfacher Leitfaden, um Ihnen den Einstieg zu erleichtern und Ihnen beizubringen, wie alles **unter der Haube** funktioniert.
@ -835,7 +835,7 @@ Sobald Sie bereit sind und ein Tool verwenden möchten, das **das gesamte Projek
* Sicherstellen, dass Sie eine **exakte** Menge an Paketen und Versionen zur Installation haben, einschließlich ihrer Abhängigkeiten, damit Sie sicher sein können, dass Sie Ihr Projekt in der Produktionsumgebung genauso ausführen können wie auf Ihrem Rechner während der Entwicklung, dies wird **Locking** genannt
* Und viele andere Dinge
## Fazit
## Fazit { #conclusion }
Wenn Sie das alles gelesen und verstanden haben, wissen Sie jetzt **viel mehr** über virtuelle Umgebungen als viele Entwickler da draußen. 🤓
Nils Lindemann
3 weeks ago