UV 快速入门和使用案例

作者：王珂

邮箱：[email protected]

文章目录

[UV 快速入门和使用案例](#UV 快速入门和使用案例)
简介
一、安装
- [1.1 安装包安装](#1.1 安装包安装)
- [1.2 从 PyPI 安装](#1.2 从 PyPI 安装)
- 二、使用
- [2.1 创建项目](#2.1 创建项目)
- [2.2 包管理](#2.2 包管理)
- [2.3 工具](#2.3 工具)
- [2.4 Python 版本](#2.4 Python 版本)

简介

官网：

url 复制代码

项目：

url 复制代码

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

UV 是一个非常快速的 Python 包管理和项目管理工具，用 Rust 语言开发。

下图是 uv 和其它工具的对比

一、安装

1.1 安装包安装

Windows 环境
cmd 复制代码
```
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```
注意：在国内无法直接访问这个地址，可先翻墙访问如下地址，根据你自己的环境下载安装包：
url 复制代码
```
https://github.com/astral-sh/uv/releases
```
例如，我的 Windows 环境选择下载 uv-x86_64-pc-windows-msvc.zip

然后将其解压，会看到解压后的目录包含两个文件：uv 和 uvx

再将解压后的命令配置的 windows 的 path 路径

打开 cmd 框架，输入命令 uv 测试，看到如下图表示配置成功

Linux 和 macOS

shell 复制代码

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

安装包方式安装后，通过下面命令进行更新

shell 复制代码

uv self update

1.2 从 PyPI 安装

pip
shell 复制代码
```
pip install uv
```
pipx
shell 复制代码
```
pipx install uv
```

二、使用

2.1 创建项目

初始化项目

假设项目根目录是 demo-uv
cmd 复制代码
```
uv init demo-uv
```
创建虚拟环境

使用上面命令，会默认创建一个虚拟环境在 .venv 目录

2.2 包管理

安装依赖
cmd 复制代码
```
uv add 包名称
```
删除依赖
cmd 复制代码
```
uv remove 包名称
```
查看包依赖结构
cmd 复制代码
```
uv tree
```
更新项目
cmd 复制代码
```
uv sync
```
运行
cmd 复制代码
```
uv run <脚本文件>
```
查看项目版本
cmd 复制代码
```
uv version
```
demo-uv v0.1.0

2.3 工具

uv 执行和安装 Python 包提供的命令行工具，类似于pipx。

cmd 复制代码

uvx pycowsay 'hello world!'

2.4 Python 版本

uv 可以安装不同的 Python 版本，并在其之间快速切换

安装多个 Python 版本
cmd 复制代码
```
uv python install 3.10 3.11 3.12
```

根据需要下载指定的 Python 版本

cmd 复制代码

$ 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 [email protected] -- 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 版本
cmd 复制代码
```
uv python pin 3.11
```

创建虚拟环境

cmd 复制代码

uv venv

复制代码

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