VAULT2077
Vault 资讯瀑布官方2026.09.15 10:19 UTC+8

astral-sh/uv 发布 0.12.14

uv 0.12.14 发布：包操作错误改用统一诊断与退出码，新增断点续传、批量导出预览及多项性能优化与修复。

中文处理结果

发布说明

发布于 2026-09-15。

包操作错误现在使用 uv 的标准诊断，具有一致的提示以及紧凑、带标签的原因链。（#17110、#21599、#21603）

包操作的退出码现在反映底层原因：预期内的失败返回 1，而已识别的操作性和内部失败返回 2。（#17110）

增强

  • 在支持时使用 HTTP Range 请求恢复中断的下载（#21570）
  • 在用户警告中显示底层原因和提示（#21565）
  • 为失败的 uv tool upgrade 操作显示解析器提示（#21566）

预览功能

  • 通过 batch-export 预览功能，在一次 uv export --batch 调用中从共享锁文件导出多个依赖选择（#21618）

性能

  • 通过在单个阻塞任务中读取 wheel 元数据，加快从本地 wheelhouse 进行依赖解析的速度（#21619）
  • 通过在受限的后台工作线程中解析 Simple API 响应，加快针对大型包索引的冷解析速度（#21593）
  • 通过在缓存读取任务中解码新的 HTTP 缓存条目，加快热缓存解析速度（#21621）

缺陷修复

  • 在每个解析器分支内选择满足 required-environments 的发行版，而不是跨分支合并不兼容的 wheel 覆盖范围（#21672）
  • 在未启用长路径支持的 Windows 系统上安装路径长度超过 MAX_PATH 的包（#21625）
  • 防止 uv python install 在 Unix 上用相对目标覆盖有效的非托管 Python 符号链接（#21639）
  • 从缺失路径段的 URL 错误中隐去凭据和签名（#21616）
  • 当缓存的 HTTP 响应重新验证失败时，避免超出配置的重试预算（#21640）
  • 在 Unix 环境中发现解释器时优先选择 bin/python 而非 bin/python3（#21559）
  • 在 --quiet 下抑制托管 Python 回退警告（#21565）
  • 使用 -q 时保持失败的 uv tool upgrade 错误可见，使用 -qq 时将其抑制（#21566）

安装 uv 0.12.14

通过 shell 脚本安装预构建二进制文件

原始正文

astral-sh/uv released 0.12.14

Release Notes

Released on 2026-09-15.

Package-operation errors now use uv's standard diagnostics, with consistent hints and compact, labeled cause chains. (#17110, #21599, #21603)

Package-operation exit codes now reflect the underlying cause: expected failures return 1, while recognized operational and internal failures return 2. (#17110)

Enhancements

  • Resume interrupted downloads with HTTP Range requests when supported (#21570)
  • Show underlying causes and hints in user warnings (#21565)
  • Show resolver hints for failed uv tool upgrade operations (#21566)

Preview features

  • Export multiple dependency selections from a shared lockfile in one uv export --batch invocation with the batch-export preview feature (#21618)

Performance

  • Speed up dependency resolution from local wheelhouses by reading wheel metadata in a single blocking task (#21619)
  • Speed up cold resolution against large package indexes by parsing Simple API responses in bounded background workers (#21593)
  • Speed up warm-cache resolution by decoding fresh HTTP cache entries in the cache-read task (#21621)

Bug fixes

  • Select releases that satisfy required-environments within each resolver fork instead of combining incompatible wheel coverage across forks (#21672)
  • Install packages with paths longer than MAX_PATH on Windows systems without long-path support enabled (#21625)
  • Prevent uv python install from overwriting valid unmanaged Python symlinks with relative targets on Unix (#21639)
  • Redact credentials and signatures from missing-path-segment URL errors (#21616)
  • Avoid exceeding the configured retry budget when cached HTTP responses fail revalidation (#21640)
  • Prefer bin/python over bin/python3 when discovering interpreters in Unix environments (#21559)
  • Suppress managed-Python fallback warnings under --quiet (#21565)
  • Keep failed uv tool upgrade errors visible with -q while suppressing them with -qq (#21566)

Install uv 0.12.14

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/uv/releases/download/0.12.14/uv-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/uv/releases/download/0.12.14/uv-installer.ps1 | iex"

Download uv 0.12.14

FilePlatformChecksum
uv-aarch64-apple-darwin.tar.gzApple Silicon macOSchecksum
uv-x86_64-apple-darwin.tar.gzIntel macOSchecksum
uv-aarch64-pc-windows-msvc.zipARM64 Windowschecksum
uv-i686-pc-windows-msvc.zipx86 Windowschecksum
uv-x86_64-pc-windows-msvc.zipx64 Windowschecksum
uv-aarch64-unknown-linux-gnu.tar.gzARM64 Linuxchecksum
uv-i686-unknown-linux-gnu.tar.gzx86 Linuxchecksum
uv-powerpc64le-unknown-linux-gnu.tar.gzPPC64LE Linuxchecksum
uv-riscv64gc-unknown-linux-gnu.tar.gzRISCV Linuxchecksum
uv-s390x-unknown-linux-gnu.tar.gzS390x Linuxchecksum
uv-x86_64-unknown-linux-gnu.tar.gzx64 Linuxchecksum
uv-armv7-unknown-linux-gnueabihf.tar.gzARMv7 Linuxchecksum
uv-aarch64-unknown-linux-musl.tar.gzARM64 MUSL Linuxchecksum
uv-i686-unknown-linux-musl.tar.gzx86 MUSL Linuxchecksum
uv-riscv64gc-unknown-linux-musl.tar.gzRISCV MUSL Linuxchecksum
uv-x86_64-unknown-linux-musl.tar.gzx64 MUSL Linuxchecksum
uv-arm-unknown-linux-musleabihf.tar.gzARMv6 MUSL Linux (Hardfloat)checksum
uv-armv7-unknown-linux-musleabihf.tar.gzARMv7 MUSL Linuxchecksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo astral-sh/uv

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>
查看原始发布