L00 ch01 — uv + mise で Python 環境構築

L00 ch01 — uv + mise で Python 環境構築

最初の 30 分で「動く環境」を作る

このチャプターのゴール

• mise で Python 3.13+ をインストール
• uv でプロジェクト作成・依存追加できる
• プロジェクト名の罠 (フレームワーク名衝突) を回避

なぜ uv / mise なのか

→ いずれも 高速 + 標準的 に進化中。本教材では uv + mise で統一。

Step 1: mise インストール

brew install mise          # macOS
curl https://mise.run | sh  # Linux / WSL2

# シェルに統合
echo 'eval "$(mise activate zsh)"' >> ~/.zshrc

Step 2: Python インストール

mise use --global python@3.13
python --version  # Python 3.13.x

Step 3: uv インストール + プロジェクト作成

brew install uv

# ⚠️ フォルダ名を `fastapi` にしない (命名衝突する)
mkdir my-api && cd my-api
uv init
uv add fastapi 'uvicorn[standard]'

罠: プロジェクト名衝突

❌ 悪い例:

mkdir fastapi && cd fastapi && uv init && uv add fastapi
# → "fastapi:dev depends on itself" エラー

✅ 良い例:

mkdir my-api && uv init && uv add fastapi

完了チェック

• [ ] mise --version 動作
• [ ] uv --version 動作
• [ ] python --version で 3.13+
• [ ] uv init でプロジェクト作成
• [ ] uv add fastapi 成功

すべて ✅ なら次は L01 print。

drill

drill/01-name-collision — 命名衝突を再現・回避

venv の場所と Activate

uv init                  # .venv/ が自動作成される
ls .venv/bin/             # python / pip / activate
source .venv/bin/activate # シェルで activate (= プロンプトに (.venv) が付く)
deactivate                # 抜ける

> uv run python ... 経由なら activate 不要 (= uv が自動でやる)。

ロックファイル uv.lock の役割

my-api/
├ pyproject.toml   ← 「使うパッケージ名」
├ uv.lock          ← 「実際にインストールした version 一覧」 (= 自動生成)
└ .venv/           ← 実際のパッケージ (= git 管理しない)

uv.lock を commit する ことで、 別マシン / 別タイミングで同じ環境を再現できる。

uv sync              # uv.lock 通りに .venv を再現

詰まりやすい場所

次に学ぶ領域