sitdraw

uv installieren und nutzen: Projekt anlegen, Paket hinzufügen, Skript ausführen

uv offiziell installieren, ein Projekt initialisieren, ein Paket hinzufügen und ein Skript mit uv run ausführen.

Um ein Python-Projekt lokal mit uv zu führen, vier Dinge: offiziell installieren, uv init, ein Paket mit uv add, dann ein Skript mit uv run.

docs.astral.sh/uv/ folgen, keine geratenen Paketnamen. Suchbegriffe: uv installieren, uv init, Skript mit uv run. Installer: astral.sh/uv.

uvAstral-Befehlsname
initschreibt pyproject.toml
runläuft in der Projektumgebung

Offizielle Binary für das Betriebssystem

macOS und Linux

Offizielles Skript: curl -LsSf https://astral.sh/uv/install.sh | sh. Oder brew install uv. Neues Terminal, uv --version.

Windows

PowerShell: irm https://astral.sh/uv/install.ps1 | iex. Neue Sitzung, uv muss auf PATH liegen.

SchrittBefehlAchten auf
Installuv --versionDie aktuelle Shell muss die offizielle Binary sehen
Projektuv init myprojectpyproject.toml muss erscheinen
Abhängigkeituv add httpxName laut PyPI; Lockdatei wird aktualisiert
Skriptuv run python hello.pyProjektumgebung; kein manuelles activate

Installieren, anlegen, Paket, Skript

  1. 01
    Installieren und Version prüfen

    docs.astral.sh/uv/getting-started/installation/ für Skript oder Homebrew. uv --version muss eine Version drucken. Fehlt der Befehl: neues Terminal und PATH.

  2. 02
    Projekt anlegen

    Im Elternordner uv init myproject, dann cd myproject. pyproject.toml sollte da sein. Leerer Ordner: bloßes uv init.

  3. 03
    Ein Paket hinzufügen

    Beispiel: uv add httpx. uv löst Abhängigkeiten, schreibt die Lockdatei, bereitet die Umgebung vor. Bei Fehler Name und Netz prüfen; keine halbe Lockdatei per Hand flicken.

  4. 04
    Skript schreiben und ausführen

    hello.py mit dem neuen Paket, dann uv run python hello.py. Interpreter festnageln: zuerst uv python install.

curl -LsSf https://astral.sh/uv/install.sh | sh
uv --version
uv init myproject
cd myproject
uv add httpx
# Nach hello.py:
uv run python hello.py
Ist das offizielle Installskript Pflicht?
Nein. Die Docs nennen auch Homebrew, WinGet und andere. Eine Quelle wählen, mit uv --version prüfen. Keine mehreren Kopien, die sich PATH streitig machen.
Muss ich selbst ein venv anlegen?
Im Alltag nein. uv add und uv run nutzen die Projektumgebung. .venv in .gitignore, nicht committen.
Unterschied uv run und python?
Ein System-python sieht Projektabhängigkeiten oft nicht. uv run wählt Interpreter und installierte Pakete des Projekts.
Ersetzt die Installation ein gemeinsames Diagramm?
Nein. Python-Toolchain. Ist das Meeting dasselbe Diagramm, sitdraw öffnen.

Zuerst uv auf PATH

Solange uv --version nicht läuft, ein gescheitertes init nicht als Template-Fehler behandeln. Meist hat die Shell den vom Installer geänderten PATH nicht geladen.

Bild beginnen