Pythonの環境をuvで作る

Pythonで開発するときは、プロジェクトごとに独立した環境(仮想環境) を作って、必要なパッケージをそこに入れます。uv は、Pythonのバージョン管理、仮想環境、パッケージの追加、プログラムの実行を、1つのコマンドでまとめて行える管理ツールです。

uvでできること

Pythonが入っていなくても、uvが必要なバージョンを自動でダウンロードして使います。

手順1: curlがあるか確認する

uvのインストールには curl を使います。「Ubuntuの初期設定」のページで入れていれば、すでにあります。次のコマンドで確認します。

which curl

/usr/bin/curl のようにパスが表示されれば、使えます。何も表示されない場合は、インストールします。

sudo apt install -y curl

手順2: uvをインストールする

WSL(Ubuntu)で、次のコマンドを実行します。

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

uvは、~/.local/bin に入ります。

wget -qO- https://astral.sh/uv/install.sh | sh

手順3: uvを使えるようにする

インストールした直後は、まだ uv コマンドが見つからないことがあります。次のコマンドで、設定を読み込みます。

source $HOME/.local/bin/env

新しいターミナルを開き直しても 同じ状態になります。

手順4: 動作を確認する

uv --version

uv 0.13.0 (...) のように、バージョンが表示されれば成功です(数字は、入れた時期によって違います)。

手順5: VS CodeでPythonを使えるようにする

VS Codeに、Pythonの拡張機能を入れます。WSLにつないだVS Codeで、次のようにします。

1. Ctrl + Shift + X で拡張機能の画面を開きます。
2. 「Python」と検索し、発行元が Microsoft のものを入れます。
3. 「WSL: Ubuntu にインストール」と表示される場合は、そちらを押します。

プロジェクトを作ったあと(次のページ)、F1 キーでコマンドパレットを開き、Python: Select Interpreter を実行します。プロジェクトの .venv を選ぶと、VS Codeがその環境のPythonを使います。

Pythonのバージョンを指定する

プロジェクトに使うPythonのバージョンは、uv init で作られる .python-version ファイルに書かれます。別のバージョンを使いたいときは、次のコマンドが使えます。

確認する

• which curl で、パスが表示される
• uv --version で、バージョンが表示される
• VS Codeに、Pythonの拡張機能が入っている

次は、「開発の流れ」の「Pythonプロジェクトを作って動かす」で、実際にプロジェクトを作ります。

うまくいかないとき

• uv: command not found と表示される: source $HOME/.local/bin/env を実行するか、ターミナルを開き直します。
• インストールのコマンドでエラーになる: インターネットにつながっているか確認します。会社や学校のネットワークでは、astral.sh へのアクセスが制限されていることがあります。

参考

• uvのインストール(公式)
• uvでPythonを管理する(公式)