• ツール統一：pip + pyenv + virtualenv → uv一本で管理
• pyproject.toml一元管理：設定ファイル1個に統合
• 爆速インストール：pyenvの10-100倍高速
• 依存関係の自動管理：手動pip freezeから卒業

6つのツール → uv 1つ

Step 1: プロジェクト初期化

# プロジェクト作成
uv init myproject
cd myproject

# 以下が自動作成される
# .venv/              仮想環境
# .python-version     Pythonバージョン
# pyproject.toml      プロジェクト設定
# uv.lock            依存関係ロックファイル

Step 2: Pythonバージョン指定

# Pythonバージョン指定（自動ダウンロード）
uv python pin 3.11

# pyenvのような遅いビルドなし！
# バイナリダウンロードで10秒以内

Step 3: パッケージ追加

# 本番依存パッケージ追加
uv add django wagtail

# 開発用パッケージ追加
uv add --dev pytest ruff pyright

Step 4: pyproject.toml確認

[project]
name = "myproject"
version = "0.1.0"
requires-python = ">=3.11"
dependencies = [
"django>=5.2.8",
"wagtail>=6.3.4",
]

[dependency-groups]
dev = [
"pytest>=8.3.4",
"ruff>=0.11.9",
"pyright>=1.1.402",
]

[project]
name = "wagtail-template"
version = "0.1.0"
requires-python = ">=3.11"
dependencies = [
"boto3>=1.38.10",
"django>=5.2,<5.3",           # メジャーアップデート防止
"django-storages>=1.14.6",
"psycopg2-binary>=2.9.10",
"wagtail>=7.1",               # セキュリティ修正は自動取得
"gunicorn>=23.0.0",
"celery>=5.3.0",
"redis>=5.0.0",
"django-allauth>=65.9.0",
"drf-spectacular>=0.27.2",
# ... 他17パッケージ
]

[dependency-groups]
dev = [
"pre-commit>=4.2.0",
"django-debug-toolbar>=5.2.0",
"ruff>=0.11.9",              # リント＆フォーマット
"pytest-django>=4.11.1",     # テスト
"pytest-cov>=6.1.1",         # カバレッジ
"pyright>=1.1.402",          # 型チェック
"django-stubs>=5.2.0",       # Django型スタブ
"boto3-stubs>=1.38.30",      # boto3型スタブ
# ... 他19パッケージ
]

[tool.uv.workspace]
members = [
"docs",
"tools",
]

# 以下、ruff, pyright等のツール設定も全て同一ファイル
# （次の記事で詳しく解説）

uvは2024年2月のリリースからわずか9ヶ月で73,000 starsを獲得。Python tooling分野で最速級の成長を記録しています。

Step 1: 現在のPythonバージョン確認

pyenv version
# 3.11.9 (set by /path/to/project/.python-version)

Step 2: uvで同じバージョンを指定

uv python pin 3.11.9
# → .python-versionに3.11.9を記録
# → uvが自動でPython 3.11.9をダウンロード

Step 3: 動作確認

uv venv
source .venv/bin/activate  # Linux/Mac
python --version
# Python 3.11.9

Step 4: pyenv削除（任意）

# 完全移行する場合のみ
# ~/.bashrc or ~/.zshrcからpyenv関連削除
# ~/.pyenvディレクトリ削除

方法1: uv initで既存プロジェクト初期化

# 既存プロジェクトディレクトリで
uv init
# → pyproject.tomlが作成される

# requirements.txtの内容を移行
# 手動でpyproject.tomlに追記するか...

# または、1つずつuv addで追加
uv add django djangorestframework
# → pyproject.tomlに自動追加

方法2: 一括移行（推奨）

# requirements.txtの各行をuv addで追加
cat requirements.txt | grep -v "^#" | grep -v "^$" | while read pkg; do
uv add "$pkg"
done

# または手動でpyproject.tomlに記述してから
uv sync

Step 3: 動作確認

uv sync
# → pyproject.tomlから環境再現

# テスト実行等で動作確認
uv run pytest

Step 4: requirements.txt削除

# 問題なければrequirements.txt削除
rm requirements.txt requirements-dev.txt

# 以降はuv add/removeで管理