什么是 uv?为什么它这么火?
uv 是由 Astral(Ruff 的开发团队)推出的下一代 Python 包管理工具,用 Rust 编写,性能极强。它能替代以下工具的大部分功能:
pip(安装包)virtualenv/venv(创建虚拟环境)pip-tools(依赖管理)pipx(安装和运行 CLI 工具)poetry(项目管理)
一个典型的使用场景是创建虚拟环境:
uv venv --python 3.12 --seed
这条命令会:
- 使用 Python 3.12 创建
.venv虚拟环境 - 自动安装
pip、setuptools等基础包(--seed参数)
但如果你执行时报错:
-bash: uv: command not found
说明 uv 还没安装!
✅ 正确安装 uv 的 3 种方式
方式一:通过 pip 安装(最简单)
uv 已发布到 PyPI,可以直接用 pip 安装:
pip install uv
如果你的 pip 版本较旧,建议先升级:
python -m pip install --upgrade pip
python -m pip install uv
✅ 优点:简单直接,适合已有 Python 环境的用户
❌ 缺点:安装的是 Python 包,非原生二进制,略慢于方式二
方式二:使用官方一键安装脚本(推荐!)
这是官方推荐的安装方式,下载的是预编译的 Rust 二进制文件,速度更快、更独立。
在 macOS/Linux 上运行:
curl -LsSf https://install.astral.sh/uv | sh
⚠️ 注意:不要使用
https://install.python-poetry.org,那是给 Poetry 用的,不是uv!
安装完成后,uv 会被放到 ~/.local/bin 目录下,你需要将其加入 PATH:
export PATH="$HOME/.local/bin:$PATH"
为了让环境变量永久生效,可以写入 shell 配置文件:

