uv:Rust 驱动的高速 Python 全流程包与项目管理器
给 Python 开发者统一管理依赖、环境和工具的 Rust 工具,比 pip 更快并带项目级锁文件。
GitHub astral-sh/uv 更新 2026-11-19 分支 main 星标 92.2K 分叉 3.9K
Rust Python 依赖管理 项目管理 PubGrub macOS/Linux/Windows

🧭 决策指南

适合,如果你

  • 你维护 Python 项目,需要 universal lockfile、.venv、uv add 和 uv sync。
    README 的 Projects 章节展示了 uv init、uv add、uv lock 和 uv sync,并明确提到 universal lockfile。
  • 你已有 requirements.in 流程,希望保留 pip 风格命令并使用平台无关解析。
    README 的 The pip interface 章节提供 uv pip compile --universal,并称其为 pip 的 drop-in replacement。
  • 你需要隔离运行或安装 ruff、pycowsay 等 Python 工具。
    README 的 Tools 章节展示了 uvx pycowsay 和 uv tool install ruff。
  • 你需要在 macOS、Linux 或 Windows 上管理多个 Python 版本。
    Highlights 写明支持 macOS、Linux、Windows;Python versions 章节展示 uv python install 3.12 3.13 3.14。

不适合,如果你

  • 你的工作流不是 Python 包、项目、脚本或 Python CLI 工具管理。
    README 核心描述是 Python package and project manager,功能章节也集中在 Projects、Scripts、Tools 和 Python versions。
  • 你要求性能结论必须有已审计的基准条件,但当前材料只有 10-100x faster 的声明。
    Highlights 将性能依据链接到 BENCHMARKS.md,但提供的材料没有包含基准环境、数据集或测试方法。
  • 你的许可证流程只接受单一 Apache License 2.0,而不接受 README 所写的 MIT 选项。
    README 的 License 章节写明 uv 可选择 Apache License 2.0 或 MIT license;基础信息则标为 Apache License 2.0。

前置条件

  • 支持 macOS、Linux 和 Windows。
  • 可通过 curl 或 pip 安装,且 README 明确写明无需 Rust 或 Python。
  • 如使用独立安装器,可运行 uv self update 更新到最新版本。
  • 项目级工作流依赖 README 所述的 universal lockfile、workspaces 和虚拟环境能力。

第一步命令(README 原文)

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

要注意

  • 不要把 uvx 与永久安装混用:README 将 uvx 定义为 uv tool run 的别名,永久安装应使用 uv tool install。
    README 的 Tools 章节分别展示 uvx pycowsay 和 uv tool install ruff。
  • uv pip compile 的平台无关结果需要显式使用 --universal,示例命令包含该参数。
    README 的 The pip interface 章节命令为 uv pip compile requirements.in --universal --output-file requirements.txt。
  • uv run example.py 会读取脚本内联元数据并创建隔离环境,不等同于直接调用系统 Python。
    README 的 Scripts 章节展示了 uv add --script example.py requests 和 uv run example.py。
  • 许可证信息存在 Apache 2.0 与 Apache 2.0/MIT 两种表述,采购或合规时需核对 License 章节。
    基础信息标注 Apache License 2.0;README 的 License 章节列出 Apache License 2.0 和 MIT license。

替代方案

  • pip:只需要传统 Python 包安装命令,不需要 uv 的项目管理、锁文件或 Python 版本管理时。
    README 的 The pip interface 章节
  • poetry:团队已经围绕 poetry 建立项目依赖管理流程,并不需要切换到 uv 的 universal lockfile 与 uv 命令体系时。
    README 的 Highlights 与 Projects 章节
  • pipx:只需要安装隔离的 Python CLI 工具,而不需要 uv 的项目、脚本和 Python 版本管理时。
    README 的 Highlights 与 Tools 章节

材料未说明

  • BENCHMARKS.md 中 10-100x 相对 pip 的硬件、缓存状态、包规模和测试版本未提供。
  • README 摘录未说明现有 requirements.txt、Poetry 或 pip-tools 项目的完整迁移边界。
  • 未提供 uv 0.13.9 对具体 Python 包、私有索引、认证方式和构建后端的兼容矩阵。
  • 未说明 universal lockfile 在所有目标操作系统和 CPU 架构上的解析限制。
  • 未提供 10 位贡献者、5 个版本和最近 10 次提交对应的发布节奏与长期维护承诺。
  • 未给出安全响应流程、依赖签名验证或供应链安全机制的说明。

💡 深度解析

6
适合 我经常交付只依赖 requests 的单文件脚本,不想为每个脚本创建完整项目或污染全局 Python;uv 能否把依赖声明和隔离运行都放进脚本流程?
适合读者: 经常编写一次性 requests 数据抓取脚本、希望依赖写在单文件中且不创建完整项目目录的自动化开发者

适合,因为 README 直接支持单文件脚本的内联依赖元数据,并会在隔离虚拟环境中执行脚本。

  • Scripts 章节先用 uv add --script example.py requests 把依赖写入脚本元数据,不要求创建完整项目。
  • 随后的 uv run example.py 会读取该元数据并安装依赖。
  • README 明确说明脚本在 isolated virtual environment 中运行,符合不污染全局 Python 的约束。
  • 该模式与 Projects 模式分开说明,适合一次性或自动化脚本,而不是把脚本依赖混入业务项目。

README 没有说明脚本元数据格式对旧版 Python、私有包索引、认证和原生扩展的完整支持范围。

  • Scripts:"uv manages dependencies and environments for single-file scripts."
  • Scripts:`uv add --script example.py requests`
  • Scripts:`uv run example.py`
  • Scripts:"Then, run the script in an isolated virtual environment."
uv add --script example.py requests
材料未说明:README 未说明脚本内联元数据对私有索引、认证配置和需要编译的原生扩展的详细限制。;README 未说明脚本依赖锁定文件或跨机器复现时的具体提交与分发方式。
适合 我需要临时运行 pycowsay、长期安装 Ruff,并让它们与项目虚拟环境隔离;uvx 和 uv tool install 能否覆盖这两种不同生命周期?
适合读者: 需要在项目环境之外使用 Ruff 等 Python CLI 工具、但不希望通过 pipx 或全局 Python 安装造成版本冲突的工程师

适合,README 对临时执行和持久安装分别提供了 uvx 与 uv tool install,并将它们放在类似 pipx 的隔离工具模型中。

  • uvx 是 uv tool run 的别名,用于在 ephemeral environment 中运行 Python 包提供的命令行工具。
  • README 用 uvx pycowsay 'hello world!' 展示无需持久安装即可执行工具。
  • uv tool install ruff 则安装 Ruff 并暴露可执行文件,适合长期使用。
  • Highlights 明确说 uv 能运行和安装 Python 包形式发布的工具,且目标是替代 pipx 等分散工具。

但 README 没有说明工具环境如何共享项目源码、插件或本地依赖;如果 CLI 必须读取项目内部模块,隔离边界可能成为限制。

  • Tools:"uv executes and installs command-line tools provided by Python packages, similar to `pipx`."
  • Tools:"Run a tool in an ephemeral environment using `uvx`"
  • Tools:`uvx pycowsay 'hello world!'`
  • Tools:`uv tool install ruff`
uvx pycowsay 'hello world!'
材料未说明:README 未说明 `uv tool install` 工具环境与项目源码、插件和本地包之间的共享机制。;README 未说明工具版本升级、回滚及企业级工具索引策略。
适合 我需要测试 CPython 3.11 到 3.14,并额外运行 PyPy 3.8;我能否用 uv 安装这些版本并让项目固定其中一个解释器?
适合读者: 同时测试 Python 3.11、3.12、3.13、3.14 和 PyPy 3.8 的库作者,需要在项目目录固定解释器版本

适合,uv 的 Python 版本管理覆盖了 CPython 多版本安装、项目目录固定,以及 README 示例中的 PyPy 运行。

  • README 展示 uv python install 3.12 3.13 3.14,说明可以一次安装多个 CPython 版本。
  • uv python pin 3.11 会在当前目录写入 .python-version,可用于项目级解释器固定。
  • uv run --python [email protected] -- python --version 展示了按需运行 PyPy 3.8 的方式。
  • uv venv --python 3.12.0 能用指定版本创建虚拟环境,适合构建测试矩阵。

不过 README 没有列出所有 Python 实现、平台组合和已安装解释器的优先级规则,因此复杂矩阵仍需要确认版本支持文档。

  • Python versions:`uv python install 3.12 3.13 3.14`
  • Python versions:`uv python pin 3.11`
  • Python versions:`uv run --python [email protected] -- python --version`
  • Python versions:`uv venv --python 3.12.0`
uv python install 3.12 3.13 3.14
材料未说明:README 未说明 Python 3.11、3.12、3.13、3.14 与 PyPy 3.8 在所有目标平台上的可用组合。;README 未说明 `.python-version`、系统 Python、Conda 或其他版本管理器同时存在时的选择优先级。
适合 我们已经依赖 pip-tools、virtualenv 和 requirements.txt,且 CI 同时覆盖 macOS、Linux、Windows;我能否在不重写项目元数据的情况下迁移到 uv?
适合读者: 维护 requirements.in/requirements.txt、使用 pip-tools 和 virtualenv、并在 macOS、Linux、Windows 上运行 CI 的 Python 应用团队

适合,因为 uv 提供与现有工作流兼容的 uv pip 接口,而不是要求立即改成项目模式。

  • README 明确将 uv 描述为 pip、pip-tools 和 virtualenv 的 drop-in replacement。
  • uv pip compile 支持把 requirements.in 编译为 requirements.txt,并可使用 --universal 生成平台无关解析结果。
  • uv pip sync requirements.txt 可以继续安装锁定依赖,因此迁移入口与现有文件结构一致。
  • README 同时声明支持 macOS、Linux 和 Windows,且无需预装 Rust 或 Python 即可通过独立安装器部署。

但 README 没有说明现有 CI 中私有索引、认证、插件或复杂条件依赖的兼容边界;这些仍需逐项核对。

  • The pip interface:"uv provides a drop-in replacement for common `pip`, `pip-tools`, and `virtualenv` commands."
  • The pip interface:`uv pip compile requirements.in --universal --output-file requirements.txt`
  • The pip interface:`uv pip sync requirements.txt`
  • Highlights:"Supports macOS, Linux, and Windows.";"Installable without Rust or Python via `curl` or `pip`."
uv pip compile requirements.in \
   --universal \
   --output-file requirements.txt
材料未说明:README 未说明现有私有索引、认证配置和 pip-tools 特殊选项的完整兼容性。;README 未说明团队现有 CI 插件或自定义 requirements 生成流程是否需要改造。
适合 我们维护一个需要 Cargo-style workspace 的大型 Python 仓库,并希望用一个 universal lockfile 覆盖不同平台;uv 是否比继续拆分多个 requirements 文件更合适?
适合读者: 需要维护 Cargo-style workspace 的多包 Python 仓库,并希望在 CI 中统一锁定依赖的应用平台团队

适合,前提是仓库依赖主要位于 Python 包管理层;uv 原生提供 workspace 和 universal lockfile,正好对应这两个约束。

  • Highlights 列出 comprehensive project management 和 universal lockfile,用于项目依赖与环境管理。
  • README 明确支持类似 Cargo 的 workspaces,适合可扩展的多包项目。
  • 项目示例采用 uv lock 记录解析结果,再用 uv sync 同步环境。
  • uv pip compile 也支持 --universal,因此既可采用现代项目模式,也可保留 requirements 工作流。

需要注意,lockfile 不会替代系统级依赖管理。README 没有保证不同 CPU 架构、原生扩展、系统库或 GPU 运行时最终安装结果完全相同;这类约束仍需由 CI 和基础设施层处理。

  • Highlights:"Provides comprehensive project management, with a universal lockfile."
  • Highlights:"Supports Cargo-style workspaces for scalable projects."
  • Projects:示例命令 `uv lock` 与 `uv sync`
  • The pip interface:`uv pip compile requirements.in --universal`
uv init example
材料未说明:README 未说明 workspace 中包间开发依赖、发布边界和复杂可选依赖的全部行为。;README 未说明 universal lockfile 对特定 CPU 架构、源码构建和系统库依赖的实际覆盖范围。
视情况 我们的 Linux CI Runner 没有预装 Rust 或 Python,且希望通过全局缓存减少重复下载;uv 是否适合作为构建环境的统一入口?
适合读者: 在受限网络的 Linux CI Runner 中构建 Python 项目、希望利用全局缓存和 Rust 原生速度,但不能依赖预装 Rust 或 Python 的发布工程师

视情况:安装门槛和缓存模型很匹配,但受限网络、凭据和缓存恢复策略并不是 README 已经替你解决的部分。

  • Highlights 说明 uv 以 Rust 编写,并可通过独立安装器部署,无需预装 Rust 或 Python。
  • uv 提供 global cache,用于依赖去重,适合多个 CI 作业复用下载内容。
  • README 明确支持 Linux,并提供 standalone installer;因此 Runner 的基础部署路径清晰。
  • 但 README 的示例强调 warm cache,且没有给出代理、离线源、私有索引认证或 CI 缓存键的配置方案。

如果网络和制品源可配置,适合;若必须完全离线或需要严格来源审计,README 信息不足以直接作出肯定判断。

  • Highlights:"Installable without Rust or Python via `curl` or `pip`."
  • Highlights:"Disk-space efficient, with a `global cache` for dependency deduplication."
  • Installation:Linux/macOS 独立安装命令 `curl -LsSf https://astral.sh/uv/install.sh | sh`
  • 项目描述:"An extremely fast Python package and project manager, written in Rust."
curl -LsSf https://astral.sh/uv/install.sh | sh
材料未说明:README 未说明受限网络、代理、离线安装、私有索引认证和 CI 缓存恢复的配置方法。;README 未说明全局缓存的权限隔离、失效清理和缓存内容完整性策略。;README 未说明供应链审计、签名验证或制品留存能力。

✨ 核心亮点

  • 以 Rust 实现,README 声称比 pip 快 10-100 倍
  • 一个工具覆盖 pip、poetry、pipx 与 pyenv
  • 项目管理包含 universal lockfile 与 Cargo-style workspaces
  • 支持 macOS、Linux、Windows,且无需预装 Rust 或 Python

🔧 工程化

  • uv init、uv add、uv lock、uv sync 管理项目依赖与 .venv
  • uv run 支持单文件脚本及 inline dependency metadata
  • uv python install 管理 CPython 3.12、3.13、3.14
  • uv pip 提供 pip 兼容接口,解析器底层使用 PubGrub

⚠️ 风险

  • 10-100 倍性能结论依赖 BENCHMARKS.md,材料未给出测试条件
  • README 称支持生产环境,但未列出具体兼容性边界
  • 基础信息写 Apache 2.0,README 又写 Apache 2.0 或 MIT 双许可证
  • 依赖解析和发布行为的边界未在摘录中覆盖,需查 PubGrub 与 publish guide

👥 适合谁?

  • 维护 Python 项目并需要 lockfile、.venv 与 uv sync 的团队
  • 仍使用 requirements.in 的团队,可迁移到 uv pip compile
  • 需要隔离运行 ruff 等 Python CLI 工具的开发者
  • 需要并行管理 CPython 3.12、3.13、3.14 的项目