1. インストール
Windows
■ winget
winget install --id astral-sh.uv --source winget
■ PowerShell
PowerShell で実行します。
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
インストール後に PATH が反映されていない場合は、表示されたインストール先を PATH に追加します。
例:
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"
設定後、次のコマンドで確認します。
uv --version
macOS
■ Homebrew
brew install uv
■ curl
curl -LsSf https://astral.sh/uv/install.sh | sh
Python 環境からインストールする場合
すでに Python がインストールされている環境では、pipx または pip から uv をインストールできます。
pipx はツールごとに分離された環境へインストールできるため、pip よりも管理しやすいです。
■ pipx
pipx install uv
■ pip
pip install uv
2. インストール確認
ターミナルを開き直して、次のコマンドを実行します。
uv --version
バージョンが表示されればセットアップ完了です。
3. uv の更新
インストール方法に合わせて更新コマンドを使います。
Windows
■ winget
winget upgrade --id astral-sh.uv --source winget
■ PowerShell
PowerShell のスタンドアロンインストーラーで入れた場合:
uv self update
macOS
■ Homebrew
brew upgrade uv
■ curl
curl のスタンドアロンインストーラーで入れた場合:
uv self update
Python 環境からインストールした場合
■ pipx
pipx upgrade uv
■ pip
pip install --upgrade uv
4. uv コマンドが認識されない場合
インストール後に uv --version が失敗する場合は、ターミナルを開き直してから、もう一度確認します。
uv --version
それでも認識されない場合は、uv のインストール先が PATH に含まれているか確認してください。
PowerShell または curl のスタンドアロンインストーラーで入れた場合、通常は次のフォルダにインストールされます。
$env:USERPROFILE\.local\bin
一時的に PATH へ追加する場合:
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"
追加後、確認します。
uv --version
補足: uv で Python をインストールする
利用可能な Python バージョンを確認します。
uv python list
Python をインストールします。
uv python install 3.12
補足: 簡単な動作確認
新しいプロジェクトを作成します。
uv init sample-project
cd sample-project
Python バージョンを固定します。
uv python pin 3.12
コマンドを実行できることを確認します。
uv run python --version