1. Einführung
Beim Entwickeln mit Python unter Ubuntu ist es häufig nötig, für verschiedene Projekte unterschiedliche Python‑Versionen zu verwenden. In solchen Fällen erweist sich das Versionsverwaltungs‑Tool pyenv als äußerst nützlich. Dieser Artikel erklärt, wie man unter Ubuntu mithilfe von pyenv mehrere Python‑Versionen einfach verwalten kann.
Die Bedeutung der Python‑Versionsverwaltung
Python‑Versionen entwickeln sich Jahr für Jahr weiter, fügen neue Features und Sicherheitspatches hinzu, während einige Programme nur mit älteren Versionen funktionieren. Daher ist es essenziell, flexibel zwischen den für jedes Projekt benötigten Versionen wechseln zu können, um effizient zu entwickeln.
Vorteile der Verwendung von Ubuntu mit pyenv
Ubuntu ist ein sehr beliebtes Betriebssystem unter Entwicklern, und das Einrichten von Python‑Umgebungen verläuft reibungslos. Durch die Nutzung von pyenv auf Ubuntu können Sie mehrere Python‑Versionen einfach installieren und zwischen ihnen wechseln, ohne die Systemumgebung zu beeinflussen, was die Verwaltung der Entwicklungsumgebung erheblich erleichtert.
2. Was ist pyenv?
pyenv ist ein Tool, das entwickelt wurde, um mehrere Python‑Versionen auf einem einzigen System einfach zu verwalten. Traditionell erforderte die Nutzung einer bestimmten Python‑Version deren systemweite Installation. Mit pyenv können Sie jedoch verschiedene Versionen pro Benutzer oder pro Projekt installieren und so eine effiziente Versionsverwaltung ermöglichen.
Hauptfunktionen von pyenv
- Verwalten mehrerer Versionen: Installieren und nutzen Sie mehrere Python‑Versionen gleichzeitig auf einem System.
- Versionswechsel: Wechseln Sie Python‑Versionen einfach projektbezogen.
- Integration mit virtuellen Umgebungen: Kombinieren Sie pyenv mit Tools wie
venvundpyenv-virtualenv, um virtuelle Umgebungen mühelos zu verwalten.
Warum pyenv praktisch ist
In Entwicklungsumgebungen benötigen manche Projekte die neueste Python‑Version, während andere auf ältere Versionen angewiesen sind. pyenv ist in solchen Szenarien äußerst hilfreich, da es Entwicklern ermöglicht, zwischen Versionen zu wechseln und Kompatibilitätsprobleme zwischen verschiedenen Projekten zu vermeiden.
3. Installation von pyenv unter Ubuntu
Bevor pyenv unter Ubuntu installiert wird, müssen mehrere Abhängigkeitspakete eingerichtet werden. Diese Abhängigkeiten sind für das korrekte Funktionieren von pyenv unerlässlich.
Installation der erforderlichen Abhängigkeiten
Zuerst installieren Sie die benötigten Pakete mit den folgenden Befehlen:
sudo apt update
sudo apt install make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev \
libffi-dev liblzma-dev
Installation von pyenv
Als nächstes installieren Sie pyenv. Die gängigste Methode besteht darin, das Repository direkt von GitHub zu klonen:
curl https://pyenv.run | bash
Setzen von Umgebungsvariablen
Fügen Sie den folgenden Code zu ~/.bashrc (oder ~/.zshrc) hinzu, damit pyenv korrekt funktioniert:
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"
Damit ist die Installation von pyenv abgeschlossen. Starten Sie Ihre Shell neu oder führen Sie source ~/.bashrc aus, um die Änderungen zu übernehmen.

4. Installation und Verwaltung von Python‑Versionen
Sobald pyenv installiert ist, können Sie mit der Installation von Python‑Versionen fortfahren. Mit pyenv lässt sich eine bestimmte Python‑Version einfach installieren und bei Bedarf zwischen ihnen wechseln.
Verfügbare Python‑Versionen prüfen und installieren
Zuerst listen Sie alle verfügbaren Python‑Versionen auf:
pyenv install --list
Wählen Sie die gewünschte Version aus und führen Sie aus:
pyenv install 3.10.8
Wechseln von Python‑Versionen
Um eine bestimmte Version global festzulegen, verwenden Sie:
pyenv global 3.10.8
Um eine Version lokal für ein bestimmtes Projektverzeichnis festzulegen, verwenden Sie pyenv local:
pyenv local 3.10.8
Damit können Sie die benötigten Python‑Versionen flexibel verwalten.
5. Erstellen virtueller Umgebungen mit pyenv
Durch die Verwendung von pyenv mit virtuellen Umgebungen können Sie für jedes Projekt unabhängige Python‑Umgebungen pflegen. Virtuelle Umgebungen ermöglichen es Ihnen, Bibliotheken und Pakete zu installieren und zu verwalten, ohne andere Projekte zu beeinflussen.
Verwendung von venv
Unter Ubuntu können Sie mit Pythons eingebauter venv‑Bibliothek ganz einfach virtuelle Umgebungen erstellen. Erstellen Sie eine virtuelle Umgebung mit:
python -m venv .venv
Aktivieren Sie die virtuelle Umgebung:
source .venv/bin/activate
Deaktivieren Sie sie mit:
deactivate
Der Einsatz virtueller Umgebungen vereinfacht das Abhängigkeits‑Management für jedes Projekt.
6. Fehlersuche bei pyenv
Bei der Nutzung von pyenv können Fehler auftreten, etwa fehlgeschlagene Installationen bestimmter Python‑Versionen oder Probleme mit den PATH‑Einstellungen. Im Folgenden finden Sie häufige Probleme und deren Lösungen:
Häufige Fehler und Lösungen
- Fehlgeschlagene Versionsinstallation: Dies kann vorkommen, wenn erforderliche Abhängigkeiten fehlen. Installieren Sie fehlende Pakete mit
sudo apt install. - Falsche PATH‑Konfiguration: Wenn das Umschalten der Python‑Version nicht funktioniert, prüfen Sie, ob die PATH‑Einstellungen korrekt zu
~/.bashrchinzugefügt wurden, und wenden Sie die Einstellungen erneut mitsource ~/.bashrcan.
7. Erweiterte Einstellungen und Nutzung
Sobald Sie die Grundlagen von pyenv beherrschen, können Sie erweiterte Einstellungen und Funktionen erkunden. Dieser Abschnitt erklärt, wie Sie Ihre Umgebung mithilfe von Plugins und anderen Paket‑Management‑Tools verbessern können.
Verwendung von pyenv‑virtualenv
pyenv unterstützt Plugins, und eines der am häufigsten genutzten ist pyenv‑virtualenv. Dieses ermöglicht ein effizienteres Management von Python‑virtuellen Umgebungen. Mit pyenv virtualenv können Sie mehrere virtuelle Umgebungen verwalten und für jedes Projekt separate Umgebungen erstellen.
Installation von pyenv‑virtualenv:
- Stellen Sie sicher, dass pyenv bereits installiert ist.
- Installieren Sie
pyenv-virtualenvmit folgendem Befehl:git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
- Erstellen Sie eine virtuelle Umgebung und aktivieren Sie sie mit:
pyenv virtualenv 3.10.8 myenv pyenv activate myenv
- Um die Umgebung zu deaktivieren, verwenden Sie
pyenv deactivate.
Integration mit anderen Paket‑Management‑Tools
Beim Entwickeln unter Ubuntu können Sie pyenv mit anderen Paket‑Managern kombinieren. Werkzeuge wie Homebrew und Miniconda sind nützlich, wenn zusätzliche Bibliotheken und Frameworks installiert werden sollen.
- Homebrew‑Integration: Obwohl Homebrew vor allem auf macOS verbreitet ist, funktioniert es auch unter Ubuntu. Um pyenv mit Homebrew zu installieren, führen Sie aus:
brew install pyenv
- Miniconda‑Integration: Miniconda ist ein leichtgewichtiges Python‑Paket‑Management‑Tool. In Kombination mit pyenv können Sie verschiedene Python‑Versionen und Paketsätze pro Umgebung nutzen. Miniconda können Sie über
pyenv installinstallieren.
8. Fazit
In diesem Artikel wurde gezeigt, wie Sie Python‑Umgebungen auf Ubuntu mithilfe von pyenv verwalten. Wir haben die Installation mehrerer Python‑Versionen, das Erstellen virtueller Umgebungen und die Fehlersuche bei gängigen Problemen behandelt.