uv の入れ方と使い方:Python プロジェクト作成、依存追加、スクリプト実行
公式手順で uv を入れ、プロジェクトを初期化し、一つの包を足し、uv run でスクリプトを実行する。
手元で uv を使って Python プロジェクトを扱うなら、先に四つ終える。公式の入れ方、uv init、uv add で一つの包、uv run でスクリプト。
docs.astral.sh/uv/ に従い、包名を当て推量しない。検索語は uv インストール、uv init、uv run でスクリプト。導入は astral.sh/uv。
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 myproject | pyproject.toml が出る |
| 依存 | uv add httpx | 包名は PyPI。ロックファイルが更新される |
| 実行 | uv run python hello.py | プロジェクト環境。手動 activate は不要 |
導入、作成、包の追加、実行
- 01入れて版を確認する
docs.astral.sh/uv/getting-started/installation/ のスクリプトか Homebrew。
uv --versionが版を出す。命令がなければ新しい端末と PATH。 - 02プロジェクトを作る
親ディレクトリで
uv init myproject、それからcd myproject。pyproject.tomlが出る。空のフォルダなら素のuv init。 - 03包を一つ足す
例として
uv add httpx。uv が依存を解き、ロックを書き、環境を用意する。失敗したら包名と網。途中のロックを手で直さない。 - 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 を今のシェルが読んでいない。