如果你是一位 Python 开发者，曾因 pip install 的安装速度而感到沮丧，或者希望 Python 的依赖管理能够像 Node.js 那样高效顺滑，那么 UV 可能正是你所需要的工具。

UV 是由 Astral 团队开发的一款超高速 Python 包管理器，旨在替代传统的 pip 和 virtualenv。它聚焦于三个关键点：性能、安全性、以及现代化开发流程的兼容性。

本文将通过一份精炼的速查手册，介绍 UV 的基本概念、安装方式，以及 Python 开发中常用的核心命令，帮助你快速上手并优化开发效率。

什么是 UV？

UV 是一款新型的 Python 包管理工具，具备以下特点：

• 类似 pip 的包管理器，但速度比 pip 快 10 到 100 倍
• 虚拟环境管理器，可替代 virtualenv 或 venv
• 由 Rust 编写，性能极致优秀
• 完全兼容 pyproject.toml 项目结构
• 一个工具，即可统一替代 pip、pip-tools、pipx、poetry、pyenv、twine、virtualenv 等多个工具的功能

安装UV

使用独立安装脚本（推荐方式）：通过 curl 下载并执行安装脚本（适用于 macOS / Linux）：

curl -LsSf https://astral.sh/uv/install.sh | sh

UV 已被收录至 Homebrew 核心软件库，亦可使用以下命令安装：

brew install uv

Windows 用户：使用 PowerShell 安装（需管理员权限）：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

通过 PyPI 安装：使用 pipx 安装（推荐独立环境）：

pipx install uv
# 也可以直接使用 pip 安装（需手动管理环境）：
pip install uv

安装完成后验证版本：uv --version

升级 UV

使用独立安装脚本安装的用户：如果你是通过 独立安装脚本 安装的 UV，可直接使用以下命令进行自我升级：

uv self update

其他安装方式（如 pip/pipx/Homebrew）：请使用对应包管理工具的升级命令。例如：

pip install --upgrade uv

对于使用 pipx 或 brew 安装的用户，也请分别使用 pipx upgrade uv 或 brew upgrade uv。

安装python

首先,查看可用和已安装的 Python 版本：

uv python list

安装指定的python版本，例如:

uv python install cpython-3.14.0a5-windows-x86_64-none

创建虚拟环境,可指定 Python 版本

UV 支持为指定的 Python 解释器版本创建虚拟环境，哪怕该版本尚未在本地安装。UV 会自动下载并配置对应解释器。

例如，以下命令将使用 Python 3.14 Alpha 5 的 自由线程（Free-threaded）版本，创建一个名为 python314free 的虚拟环境：

uv venv --python cpython-3.14.0a5+freethreaded-windows-x86_64-none python314free

激活虚拟环境

手动激活，也可以执行：

source .venv/bin/activate
# windows 下
python314free\Scripts\activate

虚拟环境中的包操作

• 安装包到当前虚拟环境：uv pip install <包名>
• 卸载包：uv pip uninstall <包名>
• 查看当前虚拟环境中的已安装包：uv pip list

项目及依赖管理：UV 的核心能力

UV 不只是一个包安装器，它支持完整的 Python 项目结构和现代依赖管理流程，天然支持 pyproject.toml，可完全替代 pip、virtualenv、requirements.txt、pip-tools、poetry 等工具组合。

① 创建新项目（推荐起步方式）

UV 提供开箱即用的项目初始化能力：

mkdir my-python-app
cd my-python-app
uv init

这条命令会自动生成一套标准化的 Python 项目结构，包括：

• pyproject.toml：项目元信息与依赖配置
• .python-version：指定 Python 版本（便于团队一致性）
• README.md：默认文档模板
• main.py：入口脚本

此时，项目已就绪，UV 会自动在该目录中创建 .venv 虚拟环境用于包管理。

② 安装依赖（添加包）

使用 uv add 安装新依赖，并自动写入 pyproject.toml 与 uv.lock：

uv add requests

③ 从 requirements.txt迁移

UV 支持一键导入已有依赖文件，适合旧项目迁移：

uv add -r requirements.txt -c constraints.txt

-r 指定依赖列表，-c 指定约束条件（可选）

UV 会将其中的包导入至 pyproject.toml，并安装到 .venv 中。

④锁定与版本控制

UV 自动维护一个 uv.lock 文件，记录确切的依赖版本，确保开发与部署环境一致。无需再维护多个 *.txt 文件。

UV 的目标是统一 Python 的开发体验：一个命令行工具，管理一切依赖、环境与项目结构，兼容标准，极致高效，零额外负担。

其他常用命令速览：提升项目管理效率

除了创建项目、安装依赖等基本操作，UV 还提供了一些常用的辅助命令，方便你更精细地管理依赖和发布流程。

• 同步环境与锁文件（确保一致性）: uv pip sync ,根据 uv.lock 文件 同步虚拟环境中的依赖，确保本地安装与锁定版本完全一致。
• 编译锁文件（从 requirements 推导 lock）： uv pip compile ,将当前项目中的依赖解析为锁定版本，生成 uv.lock 文件。
• 手动生成锁文件 ：uv lock，重新解析 pyproject.toml 中的依赖并生成/更新 uv.lock，适用于初始化或依赖变更后手动触发锁定。
• 发布项目到 PyPI 或私有源：uv publish ，将当前项目打包并发布到 Python 包索引（如 PyPI）。支持读取 pyproject.toml 中的元数据自动打包。

UV 是一个用 Rust 编写的超高速 Python 包与环境管理工具，可一站式替代 pip、virtualenv、pip-tools、poetry 等传统工具链。本文带你快速上手 UV，体验现代化 Python 项目管理的流畅与高效。