Python_UV

Published at 2026/04/11

UV

uvを使用した開発フロー

新規プロジェクト

# プロジェクト作成
uv init my-app
cd my-app

# 必要なパッケージをインストール
uv add fastapi uvicorn
uv add --dev pytest black ruff

# VSCodeで開く
code .

# VSCodeで開いたら、インタープリターを.venvのPythonに設定する

既存プロジェクト

# クローン
git clone https://github.com/user/repo.git
cd repo

# 依存関係をインストール
uv sync

# VSCodeで開く
code .

パッケージ追加

# 環境をプロジェクトの状態と同期させたい場合
uv add 新しいパッケージ

# プロジェクト関係なしに入れたい場合
uv pip install 新しいパッケージ

コマンド

# プロジェクト初期化
uv init

# パッケージ追加
uv add パッケージ名
uv add --dev パッケージ名  # 開発用

# パッケージ削除
uv remove パッケージ名

# 依存関係インストール
uv sync

# スクリプト実行
uv run python script.py
uv run pytest

# パッケージ一覧
uv pip list

# Python管理
uv python install 3.12
uv python list

# キャッシュクリア
uv cache clean

UVのインストール

Mac（HomeBrew）の場合：

brew install uv

Windows PowerShell(管理者権限)の場合：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 \| iex"

パッケージのインストール

# 基本的なパッケージインストール
uv pip install requests

# 複数パッケージの同時インストール
uv pip install pandas numpy matplotlib

# バージョン指定インストール
uv pip install django==4.2.0

仮想環境の作成と管理

# 仮想環境の作成
uv venv myproject

# 仮想環境の有効化（Linux/Macの場合）
source myproject/bin/activate

# 仮想環境の有効化（Windowsの場合）
# myproject\Scripts\activate

# 仮想環境でのパッケージインストール
uv pip install fastapi

requirements.txtとの連携方法

# requirements.txtからのインストール
# requirements.txtファイルに記載されているすべてのパッケージをインストールする
uv pip install -r requirements.txt

# 現在の環境から requirements.txt を生成
# 現在の仮想環境にインストールされているすべてのパッケージとバージョンをリストし、それをrequirements.txtに書き込む
uv pip freeze > requirements.txt

# 開発用依存関係も含めてインストール（テストツールなどの開発時に必要な依存関係も含めてインストールする）
uv pip install -r requirements-dev.txt

VSCodeでのuv活用法

  1. 拡張機能を導入：Python(Microsoft製)
  2. インタープリターの選択
    1. Cmd+Shift+P（WindowsはCtrl+Shift+P）でコマンドパレットを開く
    2. 「Python: Select Interpreter」と入力
    3. .venv内のPythonを選択