Python のパッケージマネージャ uv についての記事をまとめています。
Windows 環境での導入・活用を、できるだけ素人でも分かるように書きました。
この連載について
uv は、Python 本体の管理・仮想環境の作成・ライブラリの追加・依存関係の管理を、1つのツールでまとめて扱えるパッケージマネージャです。
この連載では、次の流れで書いています。
- まず
uvの概要と基本的な使い方を整理する - アップデート方法をまとめる
- 繰り返し作業を
batファイルにまとめる
記事一覧
1. uvとは何か？インストールと仮想環境作成まで
-
uvの概要と特徴 - Windows への
uvインストール方法（PowerShell） - 仮想環境とは何か、なぜ使うのか
-
uv initとuv syncによるプロジェクト作成
2. ライブラリ管理、Pythonの入れ方、pyproject.toml
ライブラリ管理、Pythonの入れ方、pyproject.toml
- Python 本体のインストール方法（
uv python install） -
pyproject.tomlとuv.lockの役割 -
uv addでライブラリを追加する - すでに
pyproject.tomlがある場合のuv sync
3. uv自体とPython本体をアップデートする方法
-
uv self updateでuvを更新する -
uv python install --upgradeで Python を更新する - 更新の順番と確認方法
4. ライブラリをアップデートする方法
-
uv sync --upgradeで全ライブラリを更新する -
uv sync --upgrade-packageで個別に更新する -
uv.lockとの関係
5. batファイルにする方法
| batファイル | 用途 |
|---|---|
install_uv.bat |
uv 本体の初回インストール |
uv_init_project.bat |
新規プロジェクトの作成 |
uv_sync.bat |
既存プロジェクトの環境再現 |
uv_update.bat |
uv と Python のアップデート |
エンコード（Shift JIS / ANSI）の注意点についても書いています。
6. インターネットにつながらないPCで環境を再現する方法
-
uv sync --offlineを使う考え方 -
uv.lock、キャッシュ、Python 本体の持ち込み - オンラインPCで先に準備してからオフラインPCで再現する流れ
- 再現しやすいケースと難しいケース
補足
この記事は生成AIを活用して作成しました。