UV 快速入門和使用案例

作者：王珂

郵箱：49186456@qq.com

---

---

簡介

官網：

項目：

https://github.com/astral-sh/uv

UV 是一個非常快速的 Python 包管理和項目管理工具，用 Rust 語言開發。

下圖是 uv 和 其它工具的對比

一、安裝

1.1 安裝包安裝

• Windows 環境

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

  注意：在國內無法直接訪問這個地址，可先翻墻訪問如下地址，根據你自己的環境下載安裝包：

  https://github.com/astral-sh/uv/releases
  

  例如，我的 Windows 環境選擇下載 uv-x86_64-pc-windows-msvc.zip

然后將其解壓，會看到解壓后的目錄包含兩個文件：uv 和 uvx

再將解壓后的命令配置的 windows 的 path 路徑

打開 cmd 框架，輸入命令 uv 測試，看到如下圖表示配置成功

• Linux 和 macOS

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

安裝包方式安裝后，通過下面命令進行更新

uv self update

1.2 從 PyPI 安裝

• pip

  pip install uv
  

• pipx

  pipx install uv
  

二、使用

2.1 創建項目

1. 初始化項目

   假設項目根目錄是 demo-uv

   uv init demo-uv
   

2. 創建虛擬環境

   使用上面命令，會默認創建一個虛擬環境在 .venv 目錄

2.2 包管理

• 安裝依賴

  uv add 包名稱
  

• 刪除依賴

  uv remove 包名稱
  

• 查看包依賴結構

  uv tree
  

• 更新項目

  uv sync
  

• 運行

  uv run <腳本文件>
  

• 查看項目版本

  uv version
  

  demo-uv v0.1.0

2.3 工具

uv 執行和安裝 Python 包提供的命令行工具，類似于pipx。

uvx pycowsay 'hello world!'

2.4 Python 版本

uv 可以安裝不同的 Python 版本，并在其之間快速切換

• 安裝多個 Python 版本

  uv python install 3.10 3.11 3.12
  

• 根據需要下載指定的 Python 版本

  $ uv venv --python 3.12.0
  Using Python 3.12.0
  Creating virtual environment at: .venv
  Activate with: source .venv/bin/activate$ uv run --python pypy@3.8 -- python --version
  Python 3.8.16 (a9dbdca6fc3286b0addd2240f11d97d8e8de187a, Dec 29 2022, 11:45:30)
  [PyPy 7.3.11 with GCC Apple LLVM 13.1.6 (clang-1316.0.21.2.5)] on darwin
  Type "help", "copyright", "credits" or "license" for more information.
  >>>>
  

• 使用指定的 Python 版本

  uv python pin 3.11
  

• 創建虛擬環境

  uv venv
  

  Using Python 3.12.3
  Creating virtual environment at: .venv
  Activate with: source .venv/bin/activate