使用 uv 管理 Python 環境

告別繁瑣的 Python 環境管理！ uv 是一款高效、便利的工具，可一站式解決 Python 版本管理、虛擬環境創建、套件管理以及專案管理等問題，速度快，上手簡單。本文將以 Windows PowerShell 為例，示範 uv 的使用方法，其他平台可參考官方文件進行相應調整。

安裝 uv

uv 不依賴 Python，因此不建議使用 pip 或 pipx 安裝。 Windows 系統可直接透過 PowerShell 執行下列指令安裝：

<code class="language-powershell">powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"</code>

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

<code class="language-bash">scoop install uv</code>

使用 uv 管理多版本 Python

使用 uv python list 指令查看可安裝和已安裝的 Python 版本：

<code class="language-bash"># 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="">
...</code>

安裝最新版本：

<code class="language-bash"># uv python install
Installed Python 3.13.1 in 5.89s
+ cpython-3.13.1-windows-x86_64-none</code>

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

<code class="language-bash"># 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
...</code>

取得 Python 安裝路徑：

<code class="language-bash"># uv python dir
C:\Users\meebo\AppData\Roaming\uv\python</code>

安裝指定版本：

<code class="language-bash"># uv python install 3.10
Installed Python 3.10.16 in 9.78s
+ cpython-3.10.16-windows-x86_64-none</code>

解除安裝 Python 版本 (需指定版本)：

<code class="language-bash"># 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</code>

查看所有版本 (包含所有修訂版本): uv python list --all-versions

安裝多個版本：uv python install 3.10 3.11

卸載多個版本：uv python uninstall 3.10 3.11

使用 uv 取代 python/pip 工具

uv 管理的 Python 環境不能直接用 python 指令執行，需透過 uv run 指令執行。例如：

<code class="language-python"># cat .\show_version.py
import sys
print(sys.version)</code>

執行：

<code class="language-bash"># uv run .\show_version.py
3.13.1 (main, Dec 19 2024, 14:38:48) [MSC v.1942 64 bit (AMD64)]</code>

指定 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：

<code class="language-python"># cat .\cow.py
from cowsay import cow
cow('hello, world')</code>

使用 --with 選項指定套件：

<code class="language-bash"># uv run --with cowsay .\cow.py
Installed 1 package in 13ms
...</code>

清除快取的虛擬環境：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 提供兩種專案管理方式：單一檔案專案和資料夾專案。

單一檔案項目

初始化單一檔案項目：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中文網其他相關文章！