uv 安装多版本 Python 及虚拟环境使用指南
适用系统:Ubuntu / Linux / macOS / Windows 测试环境:Ubuntu 20.04, Python 3.8 ~ 3.13
一、为什么选择 uv?
uv 是 Astral(ruff 作者团队)推出的新一代 Python 工具,核心目标是统一并简化现有的 Python 开发流程。
简单来说,它试图整合 pyenv、venv 和 pip 的功能,同时利用 Rust 带来显著的性能提升。对于追求效率的开发者来说,这意味着更少的依赖配置和更快的执行速度。
核心优势
- 极速:基于 Rust 编写,安装和运行速度远超传统工具。
- 统一管理:支持在同一机器上安装和管理多个 Python 版本,互不干扰。
- 全功能替代:内置虚拟环境管理,完全兼容
pip命令。 - 轻量级:单一二进制文件,无需复杂的环境依赖。
- IDE 友好:与 VS Code、PyCharm 等主流编辑器完美集成。
二、安装 uv
方式一:官方脚本(推荐)
这是最快捷的方式,适用于大多数 Linux 和 macOS 用户。
curl -LsSf https://astral.sh/uv/install.sh | sh
安装完成后,记得刷新环境变量:
source ~/.bashrc
验证安装是否成功:
uv --version
方式二:Cargo 安装
如果你已经安装了 Rust,也可以通过 Cargo 直接安装,但通常不如官方脚本方便。
cargo install uv
三、管理 Python 版本
查看可用版本
在安装之前,我们可以先看看有哪些版本可供下载:
uv python list
输出示例:
3.8.18 3.9.19 3.10.14 3.11.9 3.12.3 3.13.0
安装指定版本
你可以按需安装特定版本,甚至一次性安装多个版本共存。
# 安装 Python 3.12
uv python install 3.12
# 批量安装多个版本
uv python install 3.10 3.11 3.13
⚠️ 注意:uv 安装的 Python 版本独立于系统自带版本,不会覆盖系统环境。
查看已安装版本
uv python list --installed
默认存储路径通常在 ~/.local/share/uv/python/,每个版本都有独立的目录结构。
四、创建与管理虚拟环境
创建虚拟环境
在项目目录下初始化虚拟环境非常简单:

