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

安裝 uv

uv 不依賴 Python，因此不建議使用 pip 或 pipx 安裝。Windows 系統(tǒng)可直接通過(guò) 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é)果：已安裝版本會(huì)顯示安裝路徑。

# 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

安裝多個(gè)版本：uv python install 3.10 3.11

卸載多個(gè)版本：uv python uninstall 3.10 3.11

使用 uv 替代 python/pip 工具

uv 管理的 Python 環(huán)境不能直接用 python 命令執(zhí)行，需通過(guò) 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

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

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

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

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

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

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

使用 --with 選項(xiàng)指定包：

# 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 (不會(huì)自動(dòng)刪除不再需要的依賴包)

使用 uv 管理 Python 項(xiàng)目

uv 提供兩種項(xiàng)目管理方式：?jiǎn)挝募?xiàng)目和文件夾項(xiàng)目。

單文件項(xiàng)目

初始化單文件項(xiàng)目：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ù))

文件夾項(xiàng)目

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

執(zhí)行項(xiàng)目：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

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

查看項(xiàng)目包依賴關(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)境管理方案，顯著提升開(kāi)發(fā)效率。 通過(guò)本文的介紹，相信您已經(jīng)掌握了 uv 的基本使用方法，可以更好地管理您的 Python 項(xiàng)目和環(huán)境。

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