Windows下载、安装uv-0.12.0(附安装包uv-x86_64-pc-windows-msvc.zip)

发布于 2026/8/1 · 1 阅读
uvPython包管理器AstralRustpip依赖管理虚拟环境项目管理开源软件
uv 是 Astral 公司开发的极速 Python 包与项目管理器,用 Rust 编写,可替代 pip、poetry、pyenv 等多个工具,提供 10-100 倍的性能提升。

封面.png

1. uv 简介

uv 是一个用 Rust 编写的极速 Python 包与项目管理器,由 Charlie Marsh 创立的 Astral Software Inc. 开发。自 2024 年初发布以来,uv 迅速成为 Python 生态中最受瞩目的工具之一,目前在 GitHub 上拥有超过 50,000 颗星标。

uv 的愿景是用单一工具取代 Python 开发工作流中的多个工具,包括 pippip-toolspipxpoetrypyenvtwinevirtualenv。得益于 Rust 的高性能特性,uv 的依赖解析和安装速度比传统 pip 快 10-100 倍,同时提供了现代化的项目管理和锁文件机制。

uv 的核心功能包括:

  • 项目管理:类似 poetryrye,uv 管理项目依赖和环境,支持通用锁文件(universal lockfile)和 Cargo 风格的工作区(workspaces),适合从简单脚本到大型 monorepo 的各种项目规模。
  • 脚本运行:支持单文件脚本,可在脚本中通过内联元数据声明依赖,一键在隔离虚拟环境中运行。
  • 工具管理:类似 pipx,uv 可执行和安装以 Python 包形式发布的命令行工具。
  • Python 版本管理:uv 可下载、安装和切换多个 Python 版本(含 CPython 和 PyPy),按需自动获取所需版本。
  • pip 兼容接口:提供 pip installpip compilepip syncvenv 等命令的即插即用替代,无需改变现有工作流即可获得性能提升。
  • 磁盘高效:全局缓存实现依赖去重,大幅节省磁盘空间。

uv 支持 macOS、Linux 和 Windows 三大平台,安装便捷——无需预先安装 Rust 或 Python,通过一条命令即可完成安装。

2. 0.12.0 版本亮点

该版本汇集了 22 位贡献者1157 条 贡献。

uv 0.12.0 发布于 2026-07-28,是自 0.11.0(2026 年 3 月发布)以来的重大版本更新。该版本聚焦于正确性、安全性和规范兼容性的提升,虽然标记了若干破坏性变更,但团队预计大多数用户能够无感升级。

核心变更:

  • uv init 默认打包:使用 uv init 创建的新项目现在默认采用打包布局(src/ 目录 + uv_build 构建系统),源代码放在 src/<name>/ 中并包含 [project.scripts] 入口。这是对最佳实践项目布局的回归。使用 uv init --no-package 可恢复之前的非打包布局。
  • 预发布版本策略改进:默认模式改为 if-necessary,优先选择稳定版本,仅在无稳定版本满足约束时才回退到预发布版本。传递依赖中的预发布版本需求(如 example>=2.0.0b1)现在可自动解析。
  • 安全性加固:拒绝可能替换 Python 解释器的 wheel 文件;拒绝不安全的旧式压缩格式(如 .tar.bz2.tar.xz);在哈希检查模式下拒绝 MD5-only 哈希;强化 pylock.toml 验证。
  • requirements.txt 哈希检查uv pip 现在正确遵循文件中的 --require-hashes 指令,与 pip 行为保持一致。
  • 证书管理增强uv pip 支持 --cert 参数;显式证书覆盖现在严格执行,即使没有有效证书可加载也不会回退到默认信任根。
  • uv run 项目发现改进:现在基于脚本所在目录发现项目,而非当前工作目录。
  • 安全性防护uv venv --clear 需要 --force 才能清除非虚拟环境目录,防止误删数据。
  • 发布规范化uv publish 跳过文件名不符合规范的包;移除仅以 bzip2 归档的旧版 PyPy 发行版。
  • TOML 1.0 兼容uv_build 构建源码分发包时写入兼容 TOML 1.0 的 pyproject.toml
  • Unix 文件描述符自动调整:在 Linux 和 macOS 上自动提高文件打开数软限制,上限为 1,048,576。

3. 获取安装包

如果访问 GitHub 不便,安装包及中文文档:https://hanshuixin.org/go/224H(内含 uv-x86_64-pc-windows-msvc.zip、README 中英对照、发布说明中英对照和 LICENSE)。

Windows安装uv-0.12.0(uv-x86_64-pc-windows-msvc).zip
├── uv-x86_64-pc-windows-msvc.zip
├── Windows安装uv-0.12.0(uv-x86_64-pc-windows-msvc).pdf
├── README/
│   ├── README.md
│   └── README-中文版.md
├── 发布说明/
│   ├── RELEASE-NOTES.md
│   └── RELEASE-NOTES-中文版.md
└── LICENSE

4. 快速开始

uv 以压缩包形式分发,解压 uv-x86_64-pc-windows-msvc.zip 后即可获得 uv.exe 可执行文件。将其所在目录添加到系统 PATH 环境变量,或直接在该目录下打开终端使用。

常用命令

创建新项目:

uv init my-project
cd my-project

添加依赖:

uv add requests

运行项目:

uv run python main.py

安装 Python 版本:

uv python install 3.12

运行一次性工具:

uvx ruff check .

pip 兼容模式——编译依赖:

uv pip compile requirements.in --universal --output-file requirements.txt

创建虚拟环境并同步依赖:

uv venv
uv pip sync requirements.txt