機能

uvは、Pythonのインストールからシンプルなスクリプトのハッキング、大規模なプロジェクトの作業まで、Python開発に必要な機能を提供します。

uvのインターフェースはセクションに分かれており、独立してまたは一緒に使用できます。

Pythonバージョン

Python自体のインストールと管理。

• uv python install: Pythonバージョンをインストールします。
• uv python list: 利用可能なPythonバージョンを表示します。
• uv python find: インストールされたPythonバージョンを見つけます。
• uv python pin: 現在のプロジェクトで特定のPythonバージョンを使用するように固定します。
• uv python uninstall: Pythonバージョンをアンインストールします。

Pythonのインストールに関するガイドを参照してください。

スクリプト

スタンドアロンのPythonスクリプトを実行します。例：example.py。

• uv run: スクリプトを実行します。
• uv add --script: スクリプトに依存関係を追加します。
• uv remove --script: スクリプトから依存関係を削除します。

スクリプトの実行に関するガイドを参照してください。

プロジェクト

Pythonプロジェクトの作成と作業。例：pyproject.toml。

• uv init: 新しいPythonプロジェクトを作成します。
• uv add: プロジェクトに依存関係を追加します。
• uv remove: プロジェクトから依存関係を削除します。
• uv sync: プロジェクトの依存関係を環境と同期します。
• uv lock: プロジェクトの依存関係のロックファイルを作成します。
• uv run: プロジェクト環境でコマンドを実行します。
• uv tree: プロジェクトの依存関係ツリーを表示します。
• uv build: プロジェクトを配布アーカイブにビルドします。
• uv publish: プロジェクトをパッケージインデックスに公開します。

プロジェクトに関するガイドを参照してください。

ツール

Pythonパッケージインデックスに公開されたツールを実行およびインストールします。例：ruffやblack。

• uvx / uv tool run: 一時的な環境でツールを実行します。
• uv tool install: ユーザー全体にツールをインストールします。
• uv tool uninstall: ツールをアンインストールします。
• uv tool list: インストールされたツールを一覧表示します。
• uv tool update-shell: ツールの実行可能ファイルを含むようにシェルを更新します。

ツールに関するガイドを参照してください。

pipインターフェース

環境とパッケージを手動で管理します。レガシーワークフローや高レベルのコマンドが十分な制御を提供しない場合に使用します。

仮想環境の作成（venvやvirtualenvの代替）：

• uv venv: 新しい仮想環境を作成します。

環境の使用に関するドキュメントを参照してください。

環境内のパッケージを管理します（pipやpipdeptreeの代替）：

• uv pip install: 現在の環境にパッケージをインストールします。
• uv pip show: インストールされたパッケージの詳細を表示します。
• uv pip freeze: インストールされたパッケージとそのバージョンを一覧表示します。
• uv pip check: 現在の環境が互換性のあるパッケージを持っているかどうかを確認します。
• uv pip list: インストールされたパッケージを一覧表示します。
• uv pip uninstall: パッケージをアンインストールします。
• uv pip tree: 環境の依存関係ツリーを表示します。

パッケージ管理に関するドキュメントを参照してください。

環境内のパッケージをロックします（pip-toolsの代替）：

• uv pip compile: 要件をロックファイルにコンパイルします。
• uv pip sync: 環境をロックファイルと同期します。

環境のロックに関するドキュメントを参照してください。

Important

これらのコマンドは、基づいているツールのインターフェースと動作を正確に実装しているわけではありません。一般的なワークフローから外れるほど、違いに遭遇する可能性が高くなります。詳細については、pip互換性ガイドを参照してください。

ユーティリティ

uvの状態を管理および検査します。キャッシュ、ストレージディレクトリ、または自己更新の実行など。

• uv cache clean: キャッシュエントリを削除します。
• uv cache prune: 古いキャッシュエントリを削除します。
• uv cache dir: uvキャッシュディレクトリのパスを表示します。
• uv tool dir: uvツールディレクトリのパスを表示します。
• uv python dir: uvインストールされたPythonバージョンのパスを表示します。
• uv self update: uvを最新バージョンに更新します。

次のステップ

各機能の紹介についてはガイドを読み、uvの機能に関する詳細については概念ページを確認し、問題が発生した場合はヘルプの取得方法を学んでください。