告別繁瑣的 Python 環(huán)境管理！uv 是一款高效、便捷的工具，能一站式解決 Python 版本管理、虛擬環(huán)境創(chuàng)建、包管理以及項目管理等問題，速度快，上手簡單。本文將以 Windows PowerShell 為例，演示 uv 的使用方法，其他平臺可參考官方文檔進行相應調(diào)整。

安裝 uv

uv 不依賴 Python，因此不建議使用 pip 或 pipx 安裝。Windows 系統(tǒng)可直接通過 PowerShell 執(zhí)行以下命令安裝：

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

或使用 scoop 等軟件包管理器安裝：

scoop install uv

使用 uv 管理多版本 Python

使用 uv python list 命令查看可安裝和已安裝的 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

查看安裝結(jié)果：已安裝版本會顯示安裝路徑。

# 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

使用 uv 替代 python/pip 工具

uv 管理的 Python 環(huán)境不能直接用 python 命令執(zhí)行，需通過 uv run 命令執(zhí)行。例如：

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

執(zhí)行：

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

指定 Python 版本執(zhí)行：uv run --python 3.10 .show_version.py

從標準輸入執(zhí)行：echo 'print("hello world!")' | uv run -

查看已安裝的 Python 版本：uv python list --only-installed

設置默認 Python 版本 (僅限當前目錄)：uv python pin 3.10 (創(chuàng)建 .python-version 文件)

指定執(zhí)行時需要的包

如果程序需要額外包，例如 cowsay：

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

使用 --with 選項指定包：

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

清除緩存的虛擬環(huán)境：uv cache clean

管理虛擬環(huán)境

創(chuàng)建虛擬環(huán)境：uv venv --python 3.10 (創(chuàng)建 .venv 目錄) 或指定目錄名: uv venv myenv

使用指定虛擬環(huán)境：uv run --python myenv .show_version.py

刪除虛擬環(huán)境：刪除虛擬環(huán)境目錄

管理包

使用 uv pip 命令管理包，它與 pip 命令兼容。

安裝包：uv pip install cowsay

查看包依賴關(guān)系：uv pip tree

卸載包：uv pip uninstall rich (不會自動刪除不再需要的依賴包)

使用 uv 管理 Python 項目

uv 提供兩種項目管理方式：單文件項目和文件夾項目。

單文件項目

初始化單文件項目：uv init --script cow3.py --python 3.13 (在 cow3.py 文件中添加元數(shù)據(jù))

添加包：uv add --script cow3.py cowsay rich (修改 cow3.py 文件元數(shù)據(jù))

移除包：uv remove --script cow3.py rich (修改 cow3.py 文件元數(shù)據(jù))

文件夾項目

初始化文件夾項目：uv init myproject (創(chuàng)建項目目錄，包含 .gitignore, .python-version, hello.py, pyproject.toml, README.md)

執(zhí)行項目：uv run hello.py (創(chuàng)建 .venv 虛擬環(huán)境)

添加包：uv add cowsay rich (修改 pyproject.toml 文件)

更新包：uv lock --upgrade-package cowsay 或 uv lock --upgrade

移除包：uv remove cowsay

同步項目環(huán)境與 uv.lock 文件：uv sync

查看項目包依賴關(guān)系：uv tree

使用包提供的工具命令

直接執(zhí)行包命令：uvx cowsay -t 'hello, uv' 或 uv tool run cowsay -t 'hello, uv'

指定包執(zhí)行命令：uvx --from httpie http -p=b GET https://flagtech.github.io/flag.txt

安裝包命令到系統(tǒng)：uv tool install httpie

更新包命令：uv tool upgrade httpie

卸載包命令：uv tool uninstall httpie

uv 提供了高效便捷的 Python 環(huán)境管理方案，顯著提升開發(fā)效率。 通過本文的介紹，相信您已經(jīng)掌握了 uv 的基本使用方法，可以更好地管理您的 Python 項目和環(huán)境。

以上是使用 uv 管理 Python 環(huán)境的詳細內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！