Pythonで最低限のuvによる環境管理

python

Pythonの環境管理ツールであるuvを使用して、最低限の環境管理方法をまとめます

Published

2026-03-20

Modified

2026-03-20

uvとは

uvとは、Pythonの環境管理ツールです。他の環境管理ツールには、venvやvirtualenvなどがあります。

uvは他の環境管理と比べても新し目で、速度や安定性、使いやすさなどが特徴です。筆者もこれまではvenvを使用していましたが、uvに乗り換えてからは速度や安定性の向上を感じています。

また、OpenAIも2026年3月19日にuvの開発会社であるAstralを買収したこともあり、今後さらにuvの開発が加速することが期待されます。

これまで乱立していたPythonの環境管理ツールも、uvに統一されていく可能性が高いと考えられます。

大規模なプロジェクトでももちろん使用する恩恵が大きいですが、筆者のような小規模な個人開発でも、環境管理の手間が減るため、非常におすすめです。今回は、筆者のよく使う、小規模な個人開発向けの最低限で汎用性のあるuvによる環境管理方法をまとめます。

uvのインストールの方法は何通りかあります。

MacやLinuxの場合は、以下のコマンドでインストールできます。

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

Windowsの場合は、以下のコマンドでインストールできます。

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

また、Pythonのパッケージマネージャであるpipを使用してインストールすることもできます。

pip install uv

その他にもいくつかの方法が公式サイトで紹介されているため、自分にあった方法でインストールしてください。

私は確か通常のコマンドラインでインストールしたと思います。

プロジェクトのルートディレクトリで、以下のコマンドを実行して、uvのプロジェクトを初期化します。

uv init

このコマンドで、プロジェクトのルートディレクトリに、以下のファイルが作成されます。

├── .gitignore
├── .python-version
├── README.md
├── main.py
└── pyproject.toml

プロジェクトのルートディレクトリで、以下のコマンドを実行して、仮想環境を作成します。

uv venv

このコマンドで、プロジェクトのルートディレクトリに、.venvという名前の仮想環境が作成されます。

uv addコマンドを使用して、プロジェクトに必要なパッケージを追加します。

uv add numpy

このコマンドで、numpyというパッケージがプロジェクトに追加されます。追加されたパッケージは、pyproject.tomlファイルに記載されます。

プロジェクトのルートディレクトリで、以下のコマンドを実行して、仮想環境をアクティベートします。

なお、アクティベートコマンドは、仮想環境作成時にターミナルに表示されるため、そのまま実行すれば問題ありません。

source .venv/bin/activate

.venv\Scripts\activate

.pyファイルであれば、uv runコマンドを使用して、仮想環境内でコードを実行することができます。

uv run main.py

もしPositronなどで.qmdファイルを仮想環境内で簡単に実行したい場合は、以下のようにします。

これで簡単に仮想環境内でコードを実行することができます。