一个用 Rust 编写的、速度极快的 Python 包和项目管理器。

• • 全面替代 pip、pip-tools、pipx等工具
• • 速度比 pip 快 10–100 倍
• • 支持通用锁定文件、Cargo 风格工作空间、内联依赖元数据
• • 安装和管理 Python 版本
• • 运行与安装以 Python 包形式发布的工具
• • 提供与 pip 兼容的命令行，性能更高
• • 全局缓存，依赖去重，节省磁盘
• • 无需 Rust 或 Python，通过 curl 即可安装
• • 支持 macOS、Linux、Windows

安装

支持 macOS、Linux、Windows。

1
2
3
4
5
6
7
8
9
# Homebrewbrew install uv# macOS & Linuxcurl -LsSf https://astral.sh/uv/install.sh | sh# wget -qO- https://astral.sh/uv/install.sh | sh# Windowspowershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

自动补全

启用 uv 命令的 shell 自动补全功能：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# bashecho 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc# zshecho 'eval "$(uv generate-shell-completion zsh)"' >> ~/.zshrc# fishecho 'uv generate-shell-completion fish | source' > ~/.config/fish/completions/uv.fish# PowerShellif (!(Test-Path -Path $PROFILE)) {  New-Item -ItemType File -Path $PROFILE -Force}Add-Content -Path $PROFILE -Value '(& uv generate-shell-completion powershell) | Out-String | Invoke-Expression'

然后重启 shell 或加载 shell 配置文件。

镜像源

国内镜像源：

• • 中科大 USTC  https://mirrors.ustc.edu.cn/pypi/simple
• • 阿里云           https://mirrors.aliyun.com/pypi/simple
• • 清华 TUNA     https://pypi.tuna.tsinghua.edu.cn/simple
• • 华为云           https://repo.huaweicloud.com/repository/pypi/simple

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 全局指定uv config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple# 安装依赖时指定uv sync --index-url https://pypi.tuna.tsinghua.edu.cn/simple# uv 多源配置（pyproject.toml）[[tool.uv.index]]url = "https://mirrors.ustc.edu.cn/pypi/simple"default = true[[tool.uv.index]]url = "https://mirrors.aliyun.com/pypi/simple"[[tool.uv.index]]url = "https://pypi.tuna.tsinghua.edu.cn/simple"

使用

Python 管理

安装和管理 Python。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# ==安装 Python==## 安装最新版本uv python install## 安装特定版本uv python install 3.12## 重新安装（重新安装所有）uv python install --reinstall# ==查看 Python==## 查看可用和已安装uv python list# 仅显示已安装的uv python list --only-installed# ==查找 Python==## 查找已安装的 Python 版本uv python find## 查找大于 3.11 Python 版本uv python find '>=3.11'## 仅查找系统 Python 解释器uv python find --system# ==升级 Python==# 升级到最新受支持的补丁版本uv python upgrade 3.12# 升级所有uv python upgrade# ==锁定到特定的 Python 版本==# 当前项目锁定为使用特定的 Python 版本（.python-version）uv python pin# 在用户配置目录中创建全局文件uv python pin --global# ==卸载 Python==# 卸载 Python 版本uv python uninstall 3.12# 卸载所有uv python uninstall --all

项目

创建和开发 Python 项目