uv一级支持macos（apple silicon与intel x86_64）、linux x86_64、windows x86_64；二级支持linux arm64、armv7等架构；不支持windows 32位。

uv 支持哪些操作系统和 CPU 架构

uv 对主流平台提供明确的 Tier 1（一级）支持，意味着这些组合经过完整测试、稳定可用，且是官方推荐部署环境。不支持的平台可能无法运行，或出现未定义行为。

Tier 1 支持的操作系统与架构包括：

• macOS：Apple Silicon（aarch64）和 Intel x86_64（x86_64）
• Linux：x86_64（主流发行版如 Ubuntu、CentOS、Debian 均可）
• Windows：x86_64（仅 64 位，不支持 32 位 Windows）

Tier 2（二级）支持涵盖更多小众架构，但未被默认二进制包覆盖，需自行编译或依赖社区构建：

• Linux：aarch64（ARM64 服务器）、armv7（树莓派等 ARMv7 设备）、ppc64 / ppc64le（IBM Power）、s390x（IBM Z）、i686（32 位 x86）

常见误判点：

• uv 不支持 Windows 32 位（i386 或 x86），运行会报 Bad CPU type in executable 或直接退出
• macOS 上若在 Rosetta 2 模式下运行 Apple Silicon 二进制，通常能兼容，但非官方保证场景
• WSL1 不在 Tier 1 列表中；WSL2（内核为 Linux x86_64）完全支持，视为标准 Linux 环境

Python 版本兼容性直接影响 uv 行为

uv 要求宿主系统至少安装 Python 3.8，但自身不依赖系统 Python 运行 —— 它是静态链接的 Rust 二进制。真正影响的是你用 uv python install 安装的 Python 解释器版本。

目前官方测试并保证兼容的 Python 版本为：

Secure Python Code Sandbox

安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。

下载

• 3.8、3.9、3.10、3.11、3.12

注意：

• uv python install 3.13 可能成功，但属于实验性支持，uv.lock 解析或交叉编译时可能出现未声明的兼容问题
• 使用 --python-version 3.9 生成锁文件时，若本地无对应 Python，uv sync 会自动触发 uv python install 3.9 —— 这一逻辑在所有 Tier 1 平台上一致，但在 Tier 2 上可能卡在下载阶段

镜像源和网络策略在不同 OS 下表现一致吗

是的，uv 的网络行为与操作系统无关，但实际体验受底层系统限制：

• 证书验证走系统 CA 存储（Linux/macOS 用 ca-certificates 或 Keychain，Windows 用 CryptoAPI），若企业代理替换过根证书，需额外配置 SSL_CERT_FILE 或 --trusted-host
• 清华源、中科大源等 HTTP 镜像在 Windows 上偶尔因 PowerShell 默认禁用 TLS 1.2 而失败，此时应改用 curl 安装方式，或设置 $env:UV_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"
• uv pip install 默认并发数为 CPU 核心数 × 2，在 macOS M 系列芯片上调度更激进，Linux 上受 cgroup 限制时可能降级

Windows 用户最常忽略的路径权限问题

Windows 上 uv 默认将 Python 和虚拟环境写入 %LOCALAPPDATA%\uv\，该路径通常无需管理员权限。但若手动指定 --python-install-dir 到 C:\Program Files 类系统目录，会触发 UAC 提权失败，错误信息为：

error: Permission denied (os error 5)

解决方法只有两个：

• 避免写入受保护路径，坚持用默认位置
• 以管理员身份启动终端再执行命令（不推荐，破坏隔离性）

跨平台项目协作时，最容易被忽略的是 .python-version 文件里的版本写法 —— 3.11 和 3.11.10 在 Linux/macOS 上都能触发自动安装，但在某些 Windows CI 环境中，只认带补丁号的完整版本。建议统一写成 3.11.10 这类确定版本。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！