文章目录1. uv 简介2. 0.12.0 版本亮点重要变更安全性增强稳定化功能破坏性变更速览3. 获取安装包4. 快速开始常用命令1. uv 简介uv 是 Astral 团队也是 Ruff 的创建者打造的极速 Python 包与项目管理器使用 Rust 编写。由 Charlie Marsh 主导开发uv 于 2024 年 2 月首次发布最初作为 pip 的高性能替代品随后在 2024 年 8 月扩展为全面的统一 Python 打包解决方案被 Charlie Marsh 描述为Cargo, for Python。截至 2026 年初uv 在 GitHub 上已获得超过 79,000 颗星成为 Python 生态中最受瞩目的工具之一并已占据 PyPI 超过 10% 的请求量。uv 的设计目标是用一个工具统一 Python 生态中碎片化的工具链。一个 uv 即可替代pip、pip-tools、pipx、poetry、pyenv、twine、virtualenv等众多工具。其核心特点包括极速性能比 pip 快 10-100 倍得益于 Rust 编译的静态二进制、PubGrub/CDCL SAT 解析器、HTTP 范围请求、零拷贝反序列化等底层优化全面的项目管理类似 Cargo 的项目工作流uv init、uv add、uv lock、uv sync、uv run支持通用锁文件universal lockfile跨平台使用Python 版本管理自动下载、安装、切换 Python 版本支持 CPython 和 PyPy单文件脚本执行支持内联依赖元数据PEP 723用uv run script.py即可在隔离环境中运行脚本工具管理类似 pipx 的工具安装和运行能力uv tool install、uvx兼容 pip 接口uv pip子命令提供熟悉的 pip 兼容接口零学习成本迁移工作空间支持 Cargo 风格的多包仓库管理uv 支持 macOS、Linux 和 Windows无需预装 Rust 或 Python 即可通过 curl 或 pip 安装。2. 0.12.0 版本亮点uv 0.12.0 于 2026 年 7 月 28 日发布。此版本汇集了自 3 月 0.11.0 以来积累的大量改进聚焦于正确性、安全性和规范兼容性。大多数用户无需修改即可升级。重要变更uv init默认使用构建系统新创建的项目默认声明[build-system]使用 uv 自研的uv_build采用src/布局并包含[project.scripts]入口项目可直接作为命令运行。如需旧版布局可使用uv init --no-package预发布版本选择策略改进默认模式改为if-necessary——优先选择稳定版本仅在没有稳定候选版本时才回退到预发布版本。解决了传递依赖中预发布需求解析失败的问题更严格的哈希检查--require-hashes指令现在真正启用哈希检查模式拒绝仅有 MD5 哈希的依赖MD5 不具备抗碰撞性强化 Python 解释器保护拒绝可能覆盖虚拟环境解释器的 wheel 文件包括大小写变体如Python和通过.data/scripts路径绕过的文件安全性增强移除不常见压缩格式支持拒绝.tar.bz2、.tar.xz等旧版源码分发包格式遵循 PEP 625缩小处理不受信任包时的攻击面证书覆盖更严格显式设置的SSL_CERT_FILE/SSL_CERT_DIR现在完全替换默认信任根即使无法加载任何有效证书也会阻止 HTTPS 连接损坏符号链接检测发现损坏的.venv符号链接时立即报错不再回退到祖先目录中的虚拟环境uv venv --clear需--force清除非虚拟环境目录前必须显式传递--force防止误删重要数据稳定化功能兼容 TOML 1.0 的源码分发包uv_build现在生成兼容 TOML 1.0 的pyproject.toml允许旧版 Python 构建前端消费使用新版 TOML 语法的项目Unix 文件描述符限制自动调整Linux 和 macOS 上自动提高软打开文件数限制上限 1,048,576减少文件描述符耗尽导致的故障破坏性变更速览uv python install 3.12 --reinstall不再隐式升级到最新补丁版本改用--upgrade--upgrade-group必须指定已存在的依赖组--project在uv init中不可用发布时跳过文件名非规范化的分发包uv add保留绝对路径形式3. 获取安装包如果访问 GitHub 不便安装包及中文文档https://hanshuixin.org/go/224F内含 uv-x86_64-unknown-linux-gnu.tar.gz、README 中英对照、发布说明中英对照和 LICENSE。适用于 Linux x86_64glibc。Linux安装uv-0.12.0uv-x86_64-unknown-linux-gnu.zip ├── uv-x86_64-unknown-linux-gnu.tar.gz ├── Linux安装uv-0.12.0uv-x86_64-unknown-linux-gnu.pdf ├── README/ │ ├── README.md │ └── README-中文版.md ├── 发布说明/ │ ├── RELEASE-NOTES.md │ └── RELEASE-NOTES-中文版.md ├── LICENSE-MIT └── LICENSE-APACHE4. 快速开始解压uv-x86_64-unknown-linux-gnu.tar.gz将 uv 可执行文件放入PATH中即可使用# 解压安装包tarxzf uv-x86_64-unknown-linux-gnu.tar.gz# 将 uv 移至系统路径可选sudomvuv /usr/local/bin/# 验证安装uv--version常用命令# 创建新项目uv init my-projectcdmy-project# 添加依赖uvaddrequests# 运行项目uv run python main.py# 安装 Python 版本uv pythoninstall3.12# 创建虚拟环境uv venv# 同步锁文件中的依赖uvsync# 编译 requirements 文件uv pip compile requirements.in--universal--output-file requirements.txt# 运行一次性工具uvx ruff check.# 更新 uv 自身uv self update
文章目录1. uv 简介2. 0.12.0 版本亮点重要变更安全性增强稳定化功能破坏性变更速览3. 获取安装包4. 快速开始常用命令1. uv 简介uv 是 Astral 团队也是 Ruff 的创建者打造的极速 Python 包与项目管理器使用 Rust 编写。由 Charlie Marsh 主导开发uv 于 2024 年 2 月首次发布最初作为 pip 的高性能替代品随后在 2024 年 8 月扩展为全面的统一 Python 打包解决方案被 Charlie Marsh 描述为Cargo, for Python。截至 2026 年初uv 在 GitHub 上已获得超过 79,000 颗星成为 Python 生态中最受瞩目的工具之一并已占据 PyPI 超过 10% 的请求量。uv 的设计目标是用一个工具统一 Python 生态中碎片化的工具链。一个 uv 即可替代pip、pip-tools、pipx、poetry、pyenv、twine、virtualenv等众多工具。其核心特点包括极速性能比 pip 快 10-100 倍得益于 Rust 编译的静态二进制、PubGrub/CDCL SAT 解析器、HTTP 范围请求、零拷贝反序列化等底层优化全面的项目管理类似 Cargo 的项目工作流uv init、uv add、uv lock、uv sync、uv run支持通用锁文件universal lockfile跨平台使用Python 版本管理自动下载、安装、切换 Python 版本支持 CPython 和 PyPy单文件脚本执行支持内联依赖元数据PEP 723用uv run script.py即可在隔离环境中运行脚本工具管理类似 pipx 的工具安装和运行能力uv tool install、uvx兼容 pip 接口uv pip子命令提供熟悉的 pip 兼容接口零学习成本迁移工作空间支持 Cargo 风格的多包仓库管理uv 支持 macOS、Linux 和 Windows无需预装 Rust 或 Python 即可通过 curl 或 pip 安装。2. 0.12.0 版本亮点uv 0.12.0 于 2026 年 7 月 28 日发布。此版本汇集了自 3 月 0.11.0 以来积累的大量改进聚焦于正确性、安全性和规范兼容性。大多数用户无需修改即可升级。重要变更uv init默认使用构建系统新创建的项目默认声明[build-system]使用 uv 自研的uv_build采用src/布局并包含[project.scripts]入口项目可直接作为命令运行。如需旧版布局可使用uv init --no-package预发布版本选择策略改进默认模式改为if-necessary——优先选择稳定版本仅在没有稳定候选版本时才回退到预发布版本。解决了传递依赖中预发布需求解析失败的问题更严格的哈希检查--require-hashes指令现在真正启用哈希检查模式拒绝仅有 MD5 哈希的依赖MD5 不具备抗碰撞性强化 Python 解释器保护拒绝可能覆盖虚拟环境解释器的 wheel 文件包括大小写变体如Python和通过.data/scripts路径绕过的文件安全性增强移除不常见压缩格式支持拒绝.tar.bz2、.tar.xz等旧版源码分发包格式遵循 PEP 625缩小处理不受信任包时的攻击面证书覆盖更严格显式设置的SSL_CERT_FILE/SSL_CERT_DIR现在完全替换默认信任根即使无法加载任何有效证书也会阻止 HTTPS 连接损坏符号链接检测发现损坏的.venv符号链接时立即报错不再回退到祖先目录中的虚拟环境uv venv --clear需--force清除非虚拟环境目录前必须显式传递--force防止误删重要数据稳定化功能兼容 TOML 1.0 的源码分发包uv_build现在生成兼容 TOML 1.0 的pyproject.toml允许旧版 Python 构建前端消费使用新版 TOML 语法的项目Unix 文件描述符限制自动调整Linux 和 macOS 上自动提高软打开文件数限制上限 1,048,576减少文件描述符耗尽导致的故障破坏性变更速览uv python install 3.12 --reinstall不再隐式升级到最新补丁版本改用--upgrade--upgrade-group必须指定已存在的依赖组--project在uv init中不可用发布时跳过文件名非规范化的分发包uv add保留绝对路径形式3. 获取安装包如果访问 GitHub 不便安装包及中文文档https://hanshuixin.org/go/224F内含 uv-x86_64-unknown-linux-gnu.tar.gz、README 中英对照、发布说明中英对照和 LICENSE。适用于 Linux x86_64glibc。Linux安装uv-0.12.0uv-x86_64-unknown-linux-gnu.zip ├── uv-x86_64-unknown-linux-gnu.tar.gz ├── Linux安装uv-0.12.0uv-x86_64-unknown-linux-gnu.pdf ├── README/ │ ├── README.md │ └── README-中文版.md ├── 发布说明/ │ ├── RELEASE-NOTES.md │ └── RELEASE-NOTES-中文版.md ├── LICENSE-MIT └── LICENSE-APACHE4. 快速开始解压uv-x86_64-unknown-linux-gnu.tar.gz将 uv 可执行文件放入PATH中即可使用# 解压安装包tarxzf uv-x86_64-unknown-linux-gnu.tar.gz# 将 uv 移至系统路径可选sudomvuv /usr/local/bin/# 验证安装uv--version常用命令# 创建新项目uv init my-projectcdmy-project# 添加依赖uvaddrequests# 运行项目uv run python main.py# 安装 Python 版本uv pythoninstall3.12# 创建虚拟环境uv venv# 同步锁文件中的依赖uvsync# 编译 requirements 文件uv pip compile requirements.in--universal--output-file requirements.txt# 运行一次性工具uvx ruff check.# 更新 uv 自身uv self update
