1. 核心功能与设计哲学
uv 是一款用 Rust 编写的极速 Python 包管理器和工具链。它旨在用一个统一的工具，替代或增强 pip、pipx、virtualenv、pip-tools、poetry 等传统工具链中的多个组件。
它的核心设计目标可概括为三个词：极速、可靠、一体。
- 极速：得益于 Rust 的高性能实现和智能缓存策略，
uv的依赖解析和安装速度通常是传统工具的 10-100 倍。 - 可靠：它提供跨平台、可复现的依赖解析，并且首次安装就致力于提供与后续安装完全相同的结果。
- 一体：一个命令行工具，覆盖从虚拟环境管理、包安装、锁定依赖版本到运行脚本和工具的全流程。
2. 安装与快速开始
跨平台一键安装
无论你使用何种系统，安装 uv 都异常简单。
Linux 和 macOS: 在终端中执行以下命令即可完成安装：
curl -LsSf https://astral.sh/uv/install.sh | sh
安装后，重启终端或运行 source ~/.local/bin/env（具体路径根据提示调整）即可使用。
Windows: 在 PowerShell 中运行：
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
使用 pip 安装: 如果你已有一个可用的 Python 环境，也可以使用 pip 安装预览版（不推荐用于生产环境）：
pip install uv
1 分钟快速上手
安装完成后，你可以立即体验 uv 的速度。
- 创建一个新项目并进入目录：
mkdir my_project && cd my_project - 初始化项目并添加依赖：
uv会为你创建虚拟环境（./.venv）并生成pyproject.toml文件。uv init . uv add fastapi httpx - 运行你的 Python 脚本：
激活环境后，一切如常。
# 在 Linux/macOS 上 source .venv/bin/activate # 在 Windows 上 .venv\Scripts\activate python -c "import fastapi; print(fastapi.__version__)"
3. 核心工作流与命令详解
uv 通过不同的子命令来组织其强大的功能。
项目管理与依赖安装
这是 uv 的核心场景，它深度集成现代 Python 项目的 标准。
