Wie man eine Bibliothek in Python installiert: Eine vollständige Schritt-für-Schritt-Anleitung

Python ist eine der vielseitigsten und am weitesten verbreiteten Programmiersprachen der Welt, und ein Großteil ihrer Stärke stammt aus einem enormen Ökosystem von Drittanbieter-Bibliotheken. Diese Bibliotheken bieten fertig entwickelten, bewährten Code, mit dem Entwickler Webanwendungen erstellen, Arbeitsabläufe automatisieren, Datenanalysen durchführen, Machine-Learning-Modelle trainieren und vieles mehr – ohne das Rad jedes Mal neu erfinden zu müssen.

Ob Sie Python-Skripte auf Ihrem lokalen Rechner, in einer VPS Hosting-Umgebung oder auf einem dedizierten Server ausführen – zu wissen, wie man Python-Bibliotheken installiert, verwaltet und pflegt, ist eine grundlegende Fähigkeit, die jeder Entwickler und Systemadministrator beherrschen muss.

Diese Anleitung führt Sie durch jeden Schritt des Prozesses – von der Überprüfung Ihrer Python-Installation bis hin zur Verwendung virtueller Umgebungen und der Verwaltung von Abhängigkeiten in großem Maßstab.

—

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Zugang zu einem Terminal (Linux/macOS) oder der Eingabeaufforderung / PowerShell (Windows)
• Ausreichende Berechtigungen zur Installation von Software (oder eine virtuelle Umgebung, die weiter unten beschrieben wird)
• Eine aktive Internetverbindung zum Herunterladen von Paketen aus PyPI

—

Schritt 1: Überprüfen, ob Python installiert ist

Bevor Sie Bibliotheken installieren, vergewissern Sie sich, dass Python auf Ihrem System verfügbar ist.

Öffnen Sie Ihr Terminal oder die Eingabeaufforderung und führen Sie aus:

python --version

Oder auf Systemen, auf denen Python 3 explizit erforderlich ist:

python3 --version

Erwartete Ausgabe:

Python 3.11.4

Wenn Python nicht installiert ist

• Windows: Laden Sie das offizielle Installationsprogramm von https://www.python.org/downloads/ herunter. Aktivieren Sie während der Installation das Kontrollkästchen „Add Python to PATH” – dies ist entscheidend für die Ausführung von Python über die Befehlszeile.
• Ubuntu/Debian Linux:

  sudo apt update && sudo apt install python3

• CentOS/RHEL/AlmaLinux:

  sudo dnf install python3

• macOS (mit Homebrew):

  brew install python

> Sysadmin-Tipp: Auf Produktionsservern – einschließlich Dedicated Servers – installieren Sie Python bevorzugt über den Paketmanager Ihrer Distribution, um sicherzustellen, dass Sicherheits-Patches automatisch eingespielt werden.

—

Schritt 2: Überprüfen, ob pip installiert ist

pip ist Pythons Standard-Paketinstallationsprogramm. Es stellt eine Verbindung zum Python Package Index (PyPI) her – einem Repository mit Hunderttausenden von Open-Source-Bibliotheken – und übernimmt automatisch das Herunterladen, die Abhängigkeitsauflösung und die Installation.

Überprüfen Sie, ob pip verfügbar ist:

pip --version

Oder:

pip3 --version

Erwartete Ausgabe:

pip 23.2.1 from /usr/lib/python3/dist-packages/pip (python 3.11)

Wenn pip nicht installiert ist

Laden Sie das offizielle Bootstrap-Skript herunter und führen Sie es aus:

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python get-pip.py

Alternativ unter Debian/Ubuntu:

sudo apt install python3-pip

Nach der Installation ist pip einsatzbereit.

—

Schritt 3: Eine Python-Bibliothek mit pip installieren

Nachdem Python und pip bestätigt wurden, können Sie jede Bibliothek aus PyPI mit einem einzigen Befehl installieren.

Grundlegende Syntax:

pip install library_name

Beispiel – Installation der requests HTTP-Bibliothek:

pip install requests

pip wird:

1. Alle Abhängigkeiten automatisch auflösen
2. Die erforderlichen Pakete herunterladen
3. Alles in Ihrer Python-Umgebung installieren

Sie sehen eine Ausgabe ähnlich wie:

Collecting requests
  Downloading requests-2.31.0-py3-none-any.whl (62 kB)
Installing collected packages: urllib3, certifi, charset-normalizer, idna, requests
Successfully installed requests-2.31.0

—

Schritt 4: Überprüfen, ob die Bibliothek erfolgreich installiert wurde

Bestätigen Sie nach der Installation, dass die Bibliothek korrekt funktioniert, indem Sie sie in der interaktiven Python-Shell importieren.

Starten Sie die Python-Shell:

python

Versuchen Sie dann, die Bibliothek zu importieren:

import requests
print(requests.__version__)

Erwartete Ausgabe:

2.31.0

Wenn der Import ohne Fehler abgeschlossen wird, war die Installation erfolgreich. Wenn Sie einen ModuleNotFoundError sehen, wurde die Bibliothek nicht in der aktiven Python-Umgebung installiert – dies ist ein häufiges Problem, wenn mehrere Python-Versionen oder Umgebungen auf demselben System koexistieren.

—

Schritt 5: Eine bestimmte Version einer Bibliothek installieren

In Produktionsumgebungen ist das Festlegen von Abhängigkeitsversionen entscheidend. Verschiedene Versionen einer Bibliothek können sich unterschiedlich verhalten oder Breaking Changes einführen. Um eine genaue Version zu installieren:

pip install library_name==version_number

Beispiel:

pip install requests==2.25.1

Sie können auch Versionsbereiche definieren:

pip install "requests>=2.25.0,<3.0.0"

Dadurch wird die neueste kompatible Version innerhalb des angegebenen Bereichs installiert – nützlich, wenn Sie Flexibilität benötigen, ohne das Risiko von Major-Version-Upgrades einzugehen.

—

Schritt 6: Eine vorhandene Bibliothek aktualisieren

Um eine Bibliothek auf die neueste verfügbare Version zu aktualisieren:

pip install --upgrade library_name

Beispiel:

pip install --upgrade requests

Um pip selbst zu aktualisieren (regelmäßig empfohlen):

pip install --upgrade pip

> Best Practice: Testen Sie in Shared-Hosting-Umgebungen oder auf VPS mit cPanel Upgrades immer in einer virtuellen Umgebung, bevor Sie sie in der Produktion anwenden, um das Beschädigen vorhandener Anwendungen zu vermeiden.

—

Schritt 7: Mehrere Bibliotheken aus einer requirements.txt-Datei installieren

Für jedes Projekt, das über ein einfaches Skript hinausgeht, sollten Sie Ihre Abhängigkeiten in einer requirements.txt-Datei verfolgen. Dies macht Ihr Projekt auf verschiedenen Maschinen, Servern und für Teammitglieder reproduzierbar.

Erstellen einer requirements.txt-Datei

Erstellen Sie eine einfache Textdatei mit dem Namen requirements.txt und listen Sie jede Abhängigkeit mit ihrer festgelegten Version auf:

requests==2.31.0
numpy==1.25.2
pandas==2.0.3
flask==3.0.0
sqlalchemy==2.0.20

Alle Abhängigkeiten auf einmal installieren

pip install -r requirements.txt

pip liest die Datei und installiert jedes aufgelistete Paket mit der korrekten Version.

requirements.txt automatisch generieren

Wenn Sie den aktuellen Zustand Ihrer Umgebung erfassen möchten:

pip freeze > requirements.txt

Dadurch werden alle aktuell installierten Pakete und ihre genauen Versionen exportiert – ideal zum Festschreiben einer funktionierenden Umgebung vor der Bereitstellung auf einem Server.

—

Schritt 8: Virtuelle Umgebungen zur Isolierung von Abhängigkeiten verwenden

Dies ist wohl die wichtigste Best Practice in der Python-Entwicklung. Virtuelle Umgebungen erstellen isolierte Python-Umgebungen für jedes Projekt, verhindern Abhängigkeitskonflikte zwischen Projekten und halten Ihre globale Python-Installation sauber.

Warum virtuelle Umgebungen wichtig sind

Stellen Sie sich vor, Projekt A benötigt requests==2.25.1 und Projekt B benötigt requests==2.31.0. Ohne virtuelle Umgebungen kann nur eine Version global vorhanden sein – was dazu führt, dass ein Projekt nicht mehr funktioniert. Virtuelle Umgebungen lösen dieses Problem vollständig.

Schritt für Schritt: Erstellen und Verwenden einer virtuellen Umgebung

1. virtualenv installieren (falls noch nicht verfügbar):

pip install virtualenv

Alternativ können Sie das integrierte venv-Modul verwenden (Python 3.3+):

python -m venv venv

2. Eine virtuelle Umgebung in Ihrem Projektverzeichnis erstellen:

virtualenv venv

Dadurch wird ein venv/-Ordner erstellt, der einen isolierten Python-Interpreter und pip enthält.

3. Die virtuelle Umgebung aktivieren:

• Linux/macOS:

  source venv/bin/activate

• Windows (Eingabeaufforderung):

  venvScriptsactivate

• Windows (PowerShell):

  venvScriptsActivate.ps1

Nach der Aktivierung ändert sich Ihre Terminal-Eingabeaufforderung und zeigt (venv) an, was darauf hinweist, dass die isolierte Umgebung aktiv ist.

4. Bibliotheken innerhalb der virtuellen Umgebung installieren:

pip install requests flask numpy

Alle Pakete werden ausschließlich in venv/ installiert – Ihre globale Python-Installation bleibt unberührt.

5. Die virtuelle Umgebung deaktivieren, wenn Sie fertig sind:

deactivate

> Profi-Tipp: Fügen Sie Ihr venv/-Verzeichnis zu .gitignore hinzu, damit es nie in die Versionskontrolle übertragen wird. Übertragen Sie nur requirements.txt.

—

Schritt 9: Eine Bibliothek deinstallieren

Wenn Sie eine Bibliothek nicht mehr benötigen, entfernen Sie sie sauber mit:

pip uninstall library_name

Beispiel:

pip uninstall requests

pip fordert Sie zur Bestätigung auf, bevor das Paket entfernt wird. Um die Bestätigungsaufforderung zu überspringen (nützlich in Skripten):

pip uninstall -y requests

Um alle in einer requirements.txt-Datei aufgelisteten Pakete zu deinstallieren:

pip uninstall -r requirements.txt -y

—

Bonus: Nützliche pip-Befehle für die tägliche Verwaltung

—

Häufige Fehler und wie man sie behebt

ModuleNotFoundError: No module named 'requests'

Sie haben die Bibliothek mit pip installiert, verwenden aber einen anderen Python-Interpreter. Verwenden Sie python -m pip install requests, um sicherzustellen, dass pip in der richtigen Python-Version installiert.

Permission denied-Fehler unter Linux

Vermeiden Sie die globale Verwendung von sudo pip install. Verwenden Sie stattdessen eine virtuelle Umgebung oder installieren Sie nur für den aktuellen Benutzer:

pip install --user library_name

SSL-Zertifikatsfehler während der Installation

Dies kann auf Servern mit falsch konfiguriertem SSL auftreten. Stellen Sie sicher, dass die CA-Zertifikate Ihres Systems aktuell sind. Wenn Sie Ihre eigene Serverinfrastruktur verwalten, sollten Sie diese mit ordnungsgemäß ausgestellten SSL Certificates kombinieren, um eine sichere Umgebung für alle Dienste zu gewährleisten.

pip nach der Python-Installation unter Windows nicht gefunden

Stellen Sie sicher, dass Python während der Installation zum PATH hinzugefügt wurde. Führen Sie das Installationsprogramm erneut aus und wählen Sie „Ändern”, aktivieren Sie dann die PATH-Option.

—

Python-Anwendungen auf einem Server bereitstellen

Wenn Sie Python-basierte Webanwendungen, Automatisierungsskripte oder Datenpipelines erstellen, die in einer gehosteten Umgebung ausgeführt werden müssen, ist Ihre Wahl der Infrastruktur von erheblicher Bedeutung.

• VPS Hosting gibt Ihnen vollen Root-Zugriff, um jede Python-Version zu installieren, virtuelle Umgebungen zu verwalten, Systemdienste zu konfigurieren und Frameworks wie Django, Flask oder FastAPI bereitzustellen.
• Dedicated Servers sind ideal für ressourcenintensive Python-Workloads wie groß angelegte Datenverarbeitung, Web-Scraping-Infrastruktur oder APIs mit hohem Datenverkehr.
• GPU Hosting ist die richtige Wahl für Machine-Learning- und KI-Projekte, die auf Bibliotheken wie TensorFlow, PyTorch oder CUDA-beschleunigtem NumPy basieren.

—

Fazit

Das Installieren und Verwalten von Python-Bibliotheken ist eine grundlegende Fähigkeit, die sich direkt auf die Qualität, Stabilität und Reproduzierbarkeit Ihrer Projekte auswirkt. Hier ist eine kurze Zusammenfassung dessen, was wir behandelt haben:

1. Python und pip überprüfen, ob sie installiert und zugänglich sind
2. pip install verwenden, um Bibliotheken aus PyPI zu installieren
3. Bestimmte Versionen festlegen für Produktionsstabilität
4. Bibliotheken aktualisieren mit dem --upgrade-Flag
5. requirements.txt verwenden, um Projektabhängigkeiten deklarativ zu verwalten
6. Immer virtuelle Umgebungen verwenden, um Projektabhängigkeiten zu isolieren
7. Sauber deinstallieren mit pip uninstall

Wenn Sie diese Praktiken konsequent befolgen – ob Sie lokal entwickeln oder in einer VPS Hosting-Umgebung bereitstellen – werden Sie zuverlässigere, wartbarere und professionellere Python-Anwendungen erstellen.