uv の入れ方と使い方:Python プロジェクト作成、依存追加、スクリプト実行

公式手順で uv を入れ、プロジェクトを初期化し、一つの包を足し、uv run でスクリプトを実行する。

手元で uv を使って Python プロジェクトを扱うなら、先に四つ終える。公式の入れ方、uv inituv add で一つの包、uv run でスクリプト。

docs.astral.sh/uv/ に従い、包名を当て推量しない。検索語は uv インストールuv inituv run でスクリプト。導入は astral.sh/uv。

uvAstral の命令名
initpyproject.toml を書く
runプロジェクト環境で実行

OS に合わせて公式バイナリを入れる

macOS と Linux

公式スクリプト:curl -LsSf https://astral.sh/uv/install.sh | sh。または brew install uv。新しい端末で uv --version

Windows

PowerShell:irm https://astral.sh/uv/install.ps1 | iex。新しいセッションで uv が PATH にあることを確認する。

段階命令注意
導入uv --version今のシェルが公式バイナリを見つける
作成uv init myprojectpyproject.toml が出る
依存uv add httpx包名は PyPI。ロックファイルが更新される
実行uv run python hello.pyプロジェクト環境。手動 activate は不要

導入、作成、包の追加、実行

  1. 01
    入れて版を確認する

    docs.astral.sh/uv/getting-started/installation/ のスクリプトか Homebrew。uv --version が版を出す。命令がなければ新しい端末と PATH。

  2. 02
    プロジェクトを作る

    親ディレクトリで uv init myproject、それから cd myprojectpyproject.toml が出る。空のフォルダなら素の uv init

  3. 03
    包を一つ足す

    例として uv add httpx。uv が依存を解き、ロックを書き、環境を用意する。失敗したら包名と網。途中のロックを手で直さない。

  4. 04
    スクリプトを書いて走らせる

    hello.py を作り、新しい包を使い、uv run python hello.py。解釈系を固定するなら先に uv python install

curl -LsSf https://astral.sh/uv/install.sh | sh
uv --version
uv init myproject
cd myproject
uv add httpx
# hello.py を書いたあと:
uv run python hello.py
公式スクリプトは必須か。
必須ではない。文書には Homebrew や WinGet もある。一つ選び、uv --version で確かめる。PATH を奪い合う複数の副本を混ぜない。
自分で venv を作るか。
日常は不要。uv add と uv run がプロジェクト環境を使う。.venv は .gitignore へ。提出しない。
uv run と python の違いは。
システムの python はプロジェクトの依存を見ないことがある。uv run はプロジェクトの解釈系と入った包を選ぶ。
入れれば図の共有の代わりになるか。
ならない。Python のツールチェーンである。会議が同じ図なら sitdraw を開く。

先に uv を PATH に入れる

uv --version が通るまで、失敗した init をテンプレの不具合だと決めない。多くは、導入スクリプトが変えた PATH を今のシェルが読んでいない。

描き始める