UV 简介
UV 是由 Astral 开发的下一代 Python 包管理工具,旨在替代 pip、venv 等传统组合。它的核心优势在于极致的速度(依赖解析比 pip 快 10-100 倍)、一站式功能(集成虚拟环境、依赖解析、锁文件)以及对 Ubuntu 系统的原生兼容。它能方便地管理同一台电脑上的不同 Python 版本,是运行多环境程序的好帮手。
前置条件
确保本地已安装 Python 3.x 版本,并具备基本的 Linux 命令行操作能力。此外,建议本地已存在待开发的项目目录。
安装 UV
系统兼容性验证
Ubuntu 24.04.3 LTS 已满足 UV 运行要求(glibc 2.35+),无需额外依赖,直接安装即可。
| 系统 | 支持版本 | 核心依赖 |
|---|---|---|
| Linux | Ubuntu 20.04+、CentOS 8+ | glibc 2.28+ |
一键安装
打开终端,执行官方安装脚本(自动适配 x86_64 架构,无 sudo 权限也可安装):
curl -LsSf https://astral.sh/uv/install.sh | sh
安装原理说明:
- 脚本会自动下载适配 Ubuntu 24.04 的 UV 二进制文件;
- 默认安装到
~/.cargo/bin/(依赖 Rust 的 cargo 环境,脚本会自动处理); - 自动将
~/.cargo/bin/加入用户环境变量 PATH。
验证与卸载
安装完成后,重启终端使环境变量生效,执行以下命令验证:
uv --version
# 示例输出:uv 0.4.14 (a1b2c3d 2026-01-01)
若提示 command not found,可手动添加环境变量:
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
如需卸载,执行以下命令彻底清理安装文件和缓存:
rm -f ~/.cargo/bin/uv
rm -rf ~/.cache/uv
rm -rf ~/.config/uv
核心概念
在使用 UV 前,先理解 4 个核心概念,避免操作误区:
| 概念 | 作用 | 对应文件/目录 |
|---|---|---|
| 虚拟环境 | 隔离项目依赖,避免全局 Python 环境污染 | .venv/(项目根目录,默认隐藏) |
| pyproject.toml | 项目配置文件,定义依赖、Python 版本 | 项目根目录/pyproject.toml |
| uv.lock | 依赖锁文件,记录所有依赖精确版本 | 项目根目录/uv.lock |
| 缓存 |

