UV Python 环境管理完全指南

一、什么是 UV？

UV 是一个用 Rust 编写的极速 Python 包和项目管理器，由 Astral 公司开发（也是 Ruff 和 Astral 工具的开发者）。

主要特性

  • ⚡ 超快速度：比传统 pip 快 10-100 倍
  • 📦 一体化工具：替代 pip、virtualenv、pip-tools 等
  • 🔒 可靠的依赖解析：类似 Poetry 的锁定文件
  • 🌐 多 Python 版本管理：轻松切换不同 Python 版本

二、安装 UV

Windows 系统

方法1：使用 PowerShell 安装脚本（推荐）

1
2
# 打开 PowerShell（管理员权限）
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

方法2：使用 pip 安装

1
pip install uv

方法3：使用 pipx 安装（最干净）

1
2
3
4
5
6
# 先安装 pipx
pip install pipx
pipx ensurepath

# 使用 pipx 安装 uv
pipx install uv

macOS/Linux 系统

1
2
3
4
5
# 使用 curl
curl -LsSf https://astral.sh/uv/install.sh | sh

# 或者使用 brew
brew install uv

验证安装

1
2
uv --version
# 示例输出：uv 0.10.0 (0ba432459 2026-02-05)

我使用的是虚拟环境，在下载uv时候我想全局使用，在控制台输入deactivate先退出了虚拟环境，再去下载，这样下载就在D:~python310\Scripts\uv.exe目录下，我的是（D:\JB\pycharm\python310\Scripts\uv.exe），最后安装的所有包的位置也都在D:\codespace\python\test01\venv\Scripts\python.exe 文件夹下

三、依赖包管理

1. 查看已安装的包

1
2
3
4
5
6
7
8
# 查看所有包
uv pip list

# 查看详细信息（包含路径）
uv pip list -v

# 查看特定包信息
uv pip show requests

2. 更新和删除包

1
2
3
4
5
6
7
8
9
10
11
# 更新所有包
uv sync --upgrade

# 更新特定包
uv pip install --upgrade requests

# 删除包
uv remove requests

# 从 pyproject.toml 中移除并删除
uv remove --sync requests