Python の環境構築は、pip・venv・pyenv・poetry などツールが乱立しがちで、初心者にも現場にも負担が大きいのが悩みどころです。 そこで注目されているのが、Rust 製の高速パッケージマネージャー uv です。 uv はパッケージ管理、仮想環境、Python バージョン管理までを一つにまとめ、環境構築の複雑さを一気に解消してくれます。

この記事では、uv と VSCode を組み合わせて、再現性が高く高速な Python 開発環境を構築する方法を紹介します。

uv とは何か

uv は、pip や venv、pyenv、poetry の役割を一つに統合したツールです。 パッケージのインストールは従来の pip より圧倒的に速く、仮想環境も自動で管理してくれます。 さらに、ロックファイルによって環境の再現性が高まり、チーム開発や教育現場でも安心して使える点が大きな魅力です。

uv のインストール方法

uv のインストールは非常にシンプルで、公式が提供するスクリプトを実行するだけで完了します。

macOS / Linux の場合

ターミナルで次のコマンドを実行します。

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows の場合

PowerShell を管理者権限で開き、次のコマンドを実行します。

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

インストール後、以下のコマンドで正常に導入できているか確認できます。

uv --version

これで準備は完了です。

uv を使ったプロジェクトの作成方法

uv をインストールしたら、次は実際に Python プロジェクトを作成してみます。 uv の魅力は、プロジェクト作成・仮想環境作成・Python バージョン管理がすべて自動で完了する点にあります。

従来のように「フォルダを作る → venv を作る → pyenv でバージョンを切り替える → pip install …」といった手順は不要です。

1. 新しいプロジェクトを作成する

ターミナルで次のコマンドを実行します。

uv init プロジェクト名

例としてdev01という名前で作成すると、

uv init dev01
cd dev01

これだけでプロジェクトの基本構造が自動生成されます。
以下ではmain.pyなどのファイルは自動で生成されています。

2. 自動生成されるファイルと役割

pyproject.toml

uv init を実行すると、作られるファイルの役割を説明します。

パッケージ管理や依存関係を記録する設定ファイル。pip の requirements.txt より再現性が高い。

.python-version

プロジェクトで使用する Python のバージョンを指定するファイル。
uv が自動で最適なバージョンを選び、必要ならダウンロードまで行う。

main.py（サンプルコード）

最初の動作確認用として、簡単な Python ファイルが生成される。

uv は「プロジェクトを作る＝環境が整う」という設計になっているため、初心者でも迷いません。

３．パッケージを追加してみる

プロジェクトにライブラリを追加してみます。pipと同じ感覚で操作できます。
今回は、requestsライブラリを追加してみます。

uv add requests

最初にライブラリを追加した際に、プロジェクト専用のpython実行環境(.venv)を作成してくれます。

追加すると、dependenciesに追加したライブラリが追加されます。高速を歌っていることだけはあって、インストールがめちゃくちゃ早いです。5秒くらいで終わりました。

uv プロジェクトの実行方法

uv で作成したプロジェクトを実際に Python スクリプトを実行して動作を確認してみます。 uv は仮想環境を自動で管理してくれるため、特別なコマンドを覚える必要はありません。今回は自動で作成されていたmain.pyを実行してみます。

ターミナルから実行

uv run python main.py

このコマンドは、

• 仮想環境の有効化
• Python の実行

をまとめて行ってくれるため、環境を意識せずに実行できます。

VsCodeから実行

VSCode では、右上にある「▶ 実行」ボタンを押すだけでスクリプトを実行できます。

４. VSCode で開くときのポイント

プロジェクトフォルダを VSCode で開くと、uv が作った .venv を VSCode が自動で検出します。 もし検出されない場合は、コマンドパレットから「Python: Select Interpreter」を選び、.venv 内の Python を指定すれば OK です。

まとめ

uv を使ったプロジェクト作成は、従来の Python 環境構築に比べて圧倒的にシンプル且つ高速です。

これらが すべて自動で完了するため、初心者にも現場にも優しい構成になります。