安装和管理 Python
如果你的系统上已经安装了 Python,uv 将无需配置即可检测并使用它。但是,uv 也可以安装和管理 Python 版本。uv 会根据需要自动安装缺失的 Python 版本——你无需为了开始使用而预先安装 Python。
入门
要安装最新的 Python 版本:
Note
Python 官方不发布可分发的二进制文件。因此,uv 使用来自 Astral python-build-standalone
项目的发行版。更多详情请参阅 Python 发行版文档。
一旦安装了 Python,uv
命令将自动使用它。
Important
当 uv 安装 Python 后,它不会在全局范围内可用(即通过 python
命令)。
此功能的支持尚处于_预览_阶段。详情请参阅安装 Python 可执行文件。
安装特定版本
要安装特定的 Python 版本:
要安装多个 Python 版本:
要安装替代的 Python 实现,例如 PyPy:
更多详情请参阅 python install
文档。
重新安装 Python
要重新安装由 uv 管理的 Python 版本,请使用 --reinstall
,例如:
这将重新安装所有先前安装的 Python 版本。Python 发行版在不断改进,因此即使 Python 版本没有改变,重新安装也可能解决一些错误。
查看 Python 安装
要查看可用和已安装的 Python 版本:
更多详情请参阅 python list
文档。
自动下载 Python
使用 uv 无需显式安装 Python。默认情况下,当需要时,uv 会自动下载 Python 版本。例如,如果未安装 Python 3.12,以下命令将下载它:
即使没有请求特定的 Python 版本,uv 也会按需下载最新版本。例如,如果你的系统上没有 Python 版本,以下命令将在创建新虚拟环境之前安装 Python:
Tip
如果你想更好地控制 Python 的下载时机,可以轻松禁用自动下载。
使用现有的 Python 版本
如果你的系统上存在 Python 安装,uv 将会使用它们。此行为无需配置:如果系统 Python 满足命令调用的要求,uv 将使用它。详情请参阅 Python 发现文档。
要强制 uv 使用系统 Python,请提供 --no-managed-python
标志。更多详情请参阅 Python 版本偏好文档。
升级 Python 版本
Important
升级 Python 补丁版本的功能尚处于_预览_阶段。这意味着其行为是实验性的,可能会发生变化。
要将 Python 版本升级到最新的受支持补丁版本:
要升级所有由 uv 管理的 Python 版本:
更多详情请参阅 python upgrade
文档。
后续步骤
要了解有关 uv python
的更多信息,请参阅 Python 版本页面和命令参考。
或者,继续阅读以了解如何运行脚本和使用 uv 调用 Python。