Python 環境管理を uv に一本化する

目次

プロジェクトごとの Python 環境を uv だけで完結させる。

対応表

やりたいこと 従来 uv
仮想環境の作成 python -m venv .venv uv venv
パッケージ追加 pip install requests uv add requests
依存の再現 pip install -r requirements.txt uv sync
スクリプト実行 source .venv/bin/activate && python main.py uv run main.py
Python 自体の導入 pyenv など uv python install 3.13

プロジェクトの始め方

uv init myproject
cd myproject
uv add requests
uv run main.py

pyproject.tomluv.lock がコミット対象。.venv/ は無視する。

覚えておくこと

  • uv run は実行前に環境を自動同期するので activate が要らない
  • ツール類は uv tool install ruff でグローバルに入れる(pipx 相当)