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