macOS下载、安装uv-0.12.0（附安装包uv-aarch64-apple-darwin.tar.gz）

文章目录

- [1. uv 简介](#1. uv 简介)
- [2. 0.12.0 版本亮点](#2. 0.12.0 版本亮点)
- [3. 获取安装包](#3. 获取安装包)
- [4. 快速开始](#4. 快速开始)
- - 常用命令

1. uv 简介

uv 是一款使用 Rust 编写的极速 Python 包与项目管理器（package and project manager），由 Astral 团队（知名 Python 代码检查工具 Ruff 的缔造者）于 2024 年 2 月正式发布。截至 2025 年底，uv 在 GitHub 上已获得超过 71,000 颗星，贡献者超过 500 人，处理着 PyPI（Python 包索引）超过 20% 的流量，日均处理约 4-5 亿次下载请求，被广泛誉为近十年来 Python 生态中最具影响力的工具之一。

uv 的设计目标是成为 Python 工具链的"一站式"解决方案。单一 uv 命令即可替代 pip、pip-tools、pipx、poetry、pyenv、twine、virtualenv 等多个传统工具，覆盖了 Python 开发中几乎所有的包管理和项目管理需求。

uv 的核心特点：

极致性能 ：依赖解析和安装速度比 pip 快 10-100 倍。这一性能优势源自 Rust 语言的高效性以及全局缓存（global cache）机制对重复依赖项的去重处理。
全面的项目管理：提供 Cargo 风格的工作空间（workspaces）支持、通用锁文件（universal lockfile），以及从项目初始化到构建发布的完整生命周期管理。
脚本与工具运行 ：支持单文件脚本的内联依赖元数据（inline dependency metadata），以及命令行工具的临时执行和永久安装（类似 pipx）。
Python 版本管理：可安装、切换和管理多个 Python 版本，支持 CPython 和 PyPy，按需自动下载所需版本。
pip 兼容接口 ：提供与 pip 完全兼容的命令行接口（uv pip），无需改变现有工作流程即可享受极致加速。
磁盘空间高效：全局缓存机制消除重复依赖项的存储，大幅节省磁盘空间。
跨平台支持：同时支持 macOS（Apple Silicon 和 Intel）、Linux（多种架构）和 Windows。

2. 0.12.0 版本亮点

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

uv 0.12.0 于 2026 年 7 月 28 日发布，是一个重大更新版本，汇集了自 3 月 v0.11.0 以来积累的大量改进。此版本聚焦于正确性、安全性和规范兼容性的提升，同时将多个预览功能正式稳定化。

默认打包式项目布局回归 ：uv init 创建的项目现在默认使用 uv_build 构建系统，源代码位于 src/ 目录下，并自动定义入口脚本。这标志着打包式布局在历经多个版本迭代后的正式回归。如需旧的简单布局，可使用 uv init --no-package。

包格式安全加固 ：uv 现在严格遵循 PEP 625 规范，拒绝 .tar.bz2 和 .tar.xz 等旧版归档格式。Wheel 文件中的条目也只能使用 stored、DEFLATE 或 zstd 压缩方法。此外，uv 加强了对可能覆盖 Python 解释器的危险 wheel 文件的检测，包括大小写变体（如 Python、Python.exe）和 .data/scripts 目录下的解释器文件。

预发布版本处理改进 ：默认预发布模式从 if-necessary-or-explicit 改为 if-necessary------优先使用稳定版，仅在无稳定版满足约束时才回退到预发布版。这解决了传递依赖中预发布要求解析失败的问题。

哈希检查与依赖安全 ：requirements.txt 中的 --require-hashes 指令现在真正生效，而非仅警告。哈希检查模式下拒绝仅有 MD5 哈希的依赖项，要求至少一个安全摘要（如 SHA-256）。同时加强了对 pylock.toml 锁文件的格式验证。

证书处理增强 ：非空的 SSL_CERT_FILE/SSL_CERT_DIR 环境变量现在会完全替换默认证书信任根，无法加载证书时 HTTPS 请求将直接失败，避免意外回退。uv pip 命令也新增了 --cert 参数支持。

其他重要稳定化 ：包括 TOML 1.0 兼容的源码分发包生成、Unix 系统自动调整打开文件数限制、脚本目录相对项目发现（uv run）、uv venv --clear 安全保护、以及 uv publish 的非规范化文件名跳过等多项功能的稳定化。

更多详情参见整合包内 发布说明/RELEASE-NOTES-中文版.md（双语对照）。

3. 获取安装包

如果访问 GitHub 不便，安装包及中文文档：https://hanshuixin.org/go/224G（内含 uv-aarch64-apple-darwin.tar.gz、README 中英对照、发布说明中英对照和 LICENSE）。

text 复制代码

macOS安装uv-0.12.0（uv-aarch64-apple-darwin）.zip
├── uv-aarch64-apple-darwin.tar.gz
├── macOS安装uv-0.12.0（uv-aarch64-apple-darwin）.pdf
├── README/
│   ├── README.md
│   └── README-中文版.md
├── 发布说明/
│   ├── RELEASE-NOTES.md
│   └── RELEASE-NOTES-中文版.md
└── LICENSE

4. 快速开始

解压整合包后，将 uv-aarch64-apple-darwin.tar.gz 解压，得到 uv 可执行文件。可以直接运行，也可以将其移动到系统 PATH 中：

bash 复制代码

# 解压安装包
tar xzf uv-aarch64-apple-darwin.tar.gz

# 将 uv 移动到 PATH 目录（可选）
sudo mv uv /usr/local/bin/

# 验证安装
uv --version

常用命令

bash 复制代码

# 创建新项目
uv init myproject
cd myproject

# 添加依赖
uv add requests

# 运行脚本
uv run python main.py

# 安装 Python 版本
uv python install 3.12

# 运行一次性工具
uvx ruff check .

# 同步项目依赖
uv sync

# 编译依赖锁文件
uv lock