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免费学习笔记（深入）”；
目前官方测试并保证兼容的 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 这类确定版本。
