uv 多版本 Python 安装与管理使用指南
适用于：Ubuntu / Linux / macOS / Windows 本文环境：Ubuntu 20.04 Python 版本：3.8 ~ 3.13
一、uv 是什么？为什么要用 uv？
uv 是 Astral（ruff 作者）推出的新一代 Python 工具，目标是 统一并替代 现有的 Python 工具链。
一句话总结：
uv = pyenv + venv + pip 的高速合体版
uv 的核心优势
- 🚀 超快（Rust 编写）
- ✅ 安装多个 Python 版本（不依赖系统 Python）
- ✅ 创建和管理虚拟环境
- ✅ 完全替代 pip
- ✅ 单一二进制文件，无复杂依赖
- ✅ 与 VS Code / PyCharm 完美兼容
二、安装 uv（Linux / Ubuntu）
方式一：官方推荐（最简单）
curl -LsSf https://astral.sh/uv/install.sh | sh
安装完成后重新加载环境变量：
source ~/.bashrc
验证是否安装成功：
uv --version
方式二：使用 Cargo（不推荐新手）
cargo install uv
三、使用 uv 安装 Python 各种版本（重点）
1️⃣ 查看可安装的 Python 版本
uv python list
示例输出：
3.8.18 3.9.19 3.10.14 3.11.9 3.12.3 3.13.0
2️⃣ 安装指定 Python 版本
安装 Python 3.12（推荐）
uv python install 3.12
安装多个版本（可共存）
uv python install 3.10
uv python install 3.11
uv python install 3.13
⚠️ 不会覆盖系统自带 Python
3️⃣ 查看已安装的 Python 版本
uv python list --installed
4️⃣ Python 安装目录说明
~/.local/share/uv/python/
每个 Python 版本都是完全独立的目录，互不干扰。
四、使用 uv 创建虚拟环境（核心）
1️⃣ 在项目目录创建虚拟环境
cd your_project
uv venv
默认行为：
- 使用最新 Python
- 创建
.venv目录
2️⃣ 指定 Python 版本创建虚拟环境（推荐）
使用 Python 3.12
uv venv --python=3.12 .venv
使用 Python 3.10
uv venv --python=3.10 .venv
📌 推荐统一使用 .venv 作为虚拟环境目录名
3️⃣ 激活虚拟环境
source .venv/bin/activate
出现：
(.venv)
表示激活成功。
4️⃣ 退出虚拟环境
d deactivate
五、uv 替代 pip 的用法（非常快）
1️⃣ 安装依赖
uv pip install requests flask
2️⃣ 从 requirements.txt 安装
uv pip install -r requirements.txt
3️⃣ 查看已安装的包
uv pip list
4️⃣ 生成 requirements.txt
uv pip freeze > requirements.txt
六、推荐的标准项目流程（模板）
mkdir my_project
cd my_project
# 创建 Python 3.12 虚拟环境
uv venv --python=3.12 .venv
# 激活环境
source .venv/bin/activate
# 安装依赖
uv pip install fastapi uvicorn
# 运行程序
python main.py
七、uv 的高级用法
1️⃣ 不激活环境直接运行脚本
uv run python script.py
或指定 Python 版本：
uv run --python=3.12 python script.py
2️⃣ uvx：临时运行工具（实用工具）
uvx black .
uvx ruff check .
uvx pytest
特点：
- 不安装到环境
- 用完即走
- 非常适合 CI / 本地格式化
八、uv 与 pyenv / venv 对比
| 功能 | uv | pyenv | venv |
|---|---|---|---|
| 安装 Python | ✅ | ✅ | ❌ |
| 虚拟环境 | ✅ | ❌ | ✅ |
| pip 管理 | ✅ | ❌ | ❌ |
| 速度 | 🚀🚀🚀 | 慢 | 中 |
| 单工具 | ✅ | ❌ | ❌ |
✅ 新项目推荐使用直接使用 uv
九、常见问题汇总
1️⃣ IDE 找不到 Python 解释器
手动指定：
项目目录/.venv/bin/python
2️⃣ uv venv 创建失败
确认 Python 是否已安装：
uv python list --installed
3️⃣ Ubuntu 20.04 没有 Python 3.12？
uv 自带官方构建版本，不依赖系统仓库，可放心使用。
十、总结
- ✅ uv 是目前最先进、最简洁的 Python 工具链
- ✅ 完美替代 pyenv + venv + pip
- ✅ 特别适合新项目和多 Python 版本开发
一句话建议：以后新项目，直接用 uv，无需再配置 pyenv。