uv 多版本 Python 安装与管理使用指南

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

九、常见问题汇总

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。