uv を使用して Python 環境を管理する

面倒な Python 環境管理に別れを告げましょう! uv は、Python のバージョン管理、仮想環境の作成、パッケージ管理、プロジェクト管理などの問題をワンストップで解決できる効率的で便利なツールです。すぐに始めることができます。この記事では、Windows PowerShell を例として uv の使用方法を説明します。他のプラットフォームについては、対応する調整について公式ドキュメントを参照してください。

UV をインストールします

uv は Python に依存しないため、pip または pipx を使用してインストールすることはお勧めできません。 Windows システムは、PowerShell で次のコマンドを実行することで直接インストールできます:

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

または、scoop などのパッケージ マネージャーを使用してインストールします。

scoop install uv

uv を使用して Python の複数のバージョンを管理する

uv python list コマンドを使用して、インストール可能な Python バージョンとインストールされている Python バージョンを表示します:

# uv python list
cpython-3.13.1+freethreaded-windows-x86_64-none    <download available="">
cpython-3.13.1-windows-x86_64-none                 <download available="">
cpython-3.12.8-windows-x86_64-none                 <download available="">
...

最新バージョンをインストールします:

# uv python install
Installed Python 3.13.1 in 5.89s
+ cpython-3.13.1-windows-x86_64-none

インストール結果の表示: インストールされているバージョンには、インストール パスが表示されます。

# uv python list
cpython-3.13.1-windows-x86_64-none                 C:\Users\meebo\AppData\Roaming\uv\python\cpython-3.13.1-windows-x86_64-none\python.exe
...

Python のインストール パスを取得します:

# uv python dir
C:\Users\meebo\AppData\Roaming\uv\python

指定されたバージョンをインストールします:

# uv python install 3.10
Installed Python 3.10.16 in 9.78s
+ cpython-3.10.16-windows-x86_64-none

Python バージョンをアンインストールします (指定されたバージョンが必要です):

# uv python uninstall 3.10
Searching for Python versions matching: Python 3.10
Uninstalled Python 3.10.16 in 1.52s
- cpython-3.10.16-windows-x86_64-none

すべてのバージョン (すべてのリビジョンを含む) を表示: uv python list --all-versions

複数のバージョンをインストールします: uv python install 3.10 3.11

複数のバージョンをアンインストールします: uv python uninstall 3.10 3.11

Python/pip ツールの代わりに uv を使用します

uv によって管理される Python 環境は、python コマンドで直接実行することはできません。uv run コマンドを通じて実行する必要があります。例:

# cat .\show_version.py
import sys
print(sys.version)

実行:

# uv run .\show_version.py
3.13.1 (main, Dec 19 2024, 14:38:48) [MSC v.1942 64 bit (AMD64)]

実行する Python バージョンを指定します: uv run --python 3.10 .show_version.py

標準入力から実行: echo 'print("hello world!")' | uv run -

インストールされている Python バージョンの表示: uv python list --only-installed

デフォルトの Python バージョンを設定します (現在のディレクトリのみ): uv python pin 3.10 (.python-version ファイルを作成します)

実行に必要なパッケージを指定します

プログラムに cowsay などの追加パッケージが必要な場合:

# cat .\cow.py
from cowsay import cow
cow('hello, world')

--with オプションを使用してパッケージを指定します:

# uv run --with cowsay .\cow.py
Installed 1 package in 13ms
...

キャッシュされた仮想環境をクリアします: uv cache clean

仮想環境の管理

仮想環境を作成します: uv venv --python 3.10 (.venv ディレクトリを作成します) またはディレクトリ名を指定します: uv venv myenv

指定された仮想環境を使用します: uv run --python myenv .show_version.py

仮想環境の削除: 仮想環境ディレクトリを削除します

管理パック

パッケージを管理するには、uv pip コマンドと互換性のある pip コマンドを使用します。

インストールパッケージ: uv pip install cowsay

パッケージの依存関係を表示: uv pip tree

パッケージのアンインストール: uv pip uninstall rich (不要になった依存パッケージは自動的に削除されません)

UV を使用して Python プロジェクトを管理する

uv は、単一ファイル プロジェクトとフォルダー プロジェクトという 2 つのプロジェクト管理方法を提供します。

単一ファイルプロジェクト

単一ファイル プロジェクトの初期化: uv init --script cow3.py --python 3.13 (cow3.py ファイルにメタデータを追加します)

パッケージの追加: uv add --script cow3.py cowsay rich (cow3.py ファイルのメタデータを変更します)

パッケージの削除: uv remove --script cow3.py rich (cow3.py ファイルのメタデータを変更します)

フォルダー項目

フォルダー プロジェクトを初期化します: uv init myproject (.gitignore、.python-version、hello.py、pyproject.toml、README.md を含むプロジェクト ディレクトリを作成します)

実行プロジェクト: uv run hello.py (.venv 仮想環境の作成)

パッケージの追加: uv add cowsay rich (pyproject.toml ファイルを変更)

パッケージの更新: uv lock --upgrade-package cowsay または uv lock --upgrade

パッケージを削除: uv remove cowsay

プロジェクト環境を uv.lock ファイルと同期します: uv sync

プロジェクト パッケージの依存関係を表示します: uv tree

パッケージによって提供されるツール コマンドを使用します

パッケージコマンドを直接実行します: uvx cowsay -t 'hello, uv' または uv tool run cowsay -t 'hello, uv'

パッケージ実行コマンドを指定します: uvx --from httpie http -p=b GET https://flagtech.github.io/flag.txt

システムにパッケージコマンドをインストールします: uv tool install httpie

パッケージ更新コマンド: uv tool upgrade httpie

パッケージのアンインストール コマンド: uv tool uninstall httpie

uv は効率的で便利な Python 環境管理ソリューションを提供し、開発効率を大幅に向上させます。 この記事の導入により、uv の基本的な使用法をマスターし、Python プロジェクトと環境をより適切に管理できるようになったと思います。

以上がuv を使用して Python 環境を管理するの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。