Skip to content
閲覧中:
1.uv

1.uv

次世代のPythonパッケージ・プロジェクト管理ツールであるuvの基本的な使いかたをまとめました。非常に高速で、これ1つでPythonのインストールからプロジェクト管理まで完結します。

1. インストール

OSに合わせて以下のコマンドを実行してください。 * macOS / Linux:

Bash
curl -LsSf https://astral.sh/uv/install.sh | sh
* Windows (PowerShell):
PowerShell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

2. フォルダ作成と初期化

プロジェクト用のディレクトリを作成し、uvプロジェクトとして初期化します。

Bash
# フォルダ作成
mkdir my-project
cd my-project

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

uv init を実行すると、pyproject.toml や .python-version などの基本ファイルが自動生成されます。

3. Pythonバージョンの固定

プロジェクトで使用するPythonのバージョンを指定します。uvが自動で該当バージョンをダウンロードして管理してくれます。

Bash
# 例:3.12.x に固定する場合
uv python pin 3.12
実行後、ディレクトリ内に .python-version ファイルが作成され、チームメンバーも同じバージョンが強制されるようになります。

4. 仮想環境の作成と有効化

プロジェクト専用の仮想環境(.venv)を作成します。

Bash
# 仮想環境の作成
uv venv
有効化のコマンド: * macOS / Linux: source .venv/bin/activate * Windows: .venv\Scripts\activate

💡 便利な補足

uv の真骨頂は、仮想環境を意識せずにコマンドを叩ける**点にあります。 * **パッケージの追加: uv add requests * スクリプトの実行: uv run main.py * (これだけで、必要なら仮想環境の作成や同期を自動で行ってから実行してくれます)