文章目录1. uv 简介2. 0.12.0 版本亮点3. 获取安装包4. 快速开始常用命令1. uv 简介uv 是一个用 Rust 编写的极速 Python 包与项目管理器由 Charlie Marsh 创立的 Astral Software Inc. 开发。自 2024 年初发布以来uv 迅速成为 Python 生态中最受瞩目的工具之一目前在 GitHub 上拥有超过 50,000 颗星标。uv 的愿景是用单一工具取代 Python 开发工作流中的多个工具包括pip、pip-tools、pipx、poetry、pyenv、twine和virtualenv。得益于 Rust 的高性能特性uv 的依赖解析和安装速度比传统pip快 10-100 倍同时提供了现代化的项目管理和锁文件机制。uv 的核心功能包括项目管理类似poetry或ryeuv 管理项目依赖和环境支持通用锁文件universal lockfile和 Cargo 风格的工作区workspaces适合从简单脚本到大型 monorepo 的各种项目规模。脚本运行支持单文件脚本可在脚本中通过内联元数据声明依赖一键在隔离虚拟环境中运行。工具管理类似pipxuv 可执行和安装以 Python 包形式发布的命令行工具。Python 版本管理uv 可下载、安装和切换多个 Python 版本含 CPython 和 PyPy按需自动获取所需版本。pip 兼容接口提供pip install、pip compile、pip sync、venv等命令的即插即用替代无需改变现有工作流即可获得性能提升。磁盘高效全局缓存实现依赖去重大幅节省磁盘空间。uv 支持 macOS、Linux 和 Windows 三大平台安装便捷——无需预先安装 Rust 或 Python通过一条命令即可完成安装。2. 0.12.0 版本亮点该版本汇集了22 位贡献者的1157 条贡献。uv 0.12.0 发布于 2026-07-28是自 0.11.02026 年 3 月发布以来的重大版本更新。该版本聚焦于正确性、安全性和规范兼容性的提升虽然标记了若干破坏性变更但团队预计大多数用户能够无感升级。核心变更uv init默认打包使用uv init创建的新项目现在默认采用打包布局src/目录 uv_build构建系统源代码放在src/name/中并包含[project.scripts]入口。这是对最佳实践项目布局的回归。使用uv init --no-package可恢复之前的非打包布局。预发布版本策略改进默认模式改为if-necessary优先选择稳定版本仅在无稳定版本满足约束时才回退到预发布版本。传递依赖中的预发布版本需求如example2.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.0uv-x86_64-pc-windows-msvc.zip ├── uv-x86_64-pc-windows-msvc.zip ├── Windows安装uv-0.12.0uv-x86_64-pc-windows-msvc.pdf ├── README/ │ ├── README.md │ └── README-中文版.md ├── 发布说明/ │ ├── RELEASE-NOTES.md │ └── RELEASE-NOTES-中文版.md └── LICENSE4. 快速开始uv 以压缩包形式分发解压uv-x86_64-pc-windows-msvc.zip后即可获得uv.exe可执行文件。将其所在目录添加到系统 PATH 环境变量或直接在该目录下打开终端使用。常用命令创建新项目uv init my-projectcdmy-project添加依赖uvaddrequests运行项目uv run python main.py安装 Python 版本uv pythoninstall3.12运行一次性工具uvx ruff check.pip 兼容模式——编译依赖uv pip compile requirements.in--universal--output-file requirements.txt创建虚拟环境并同步依赖uv venv uv pipsyncrequirements.txt
