安装 Python
如果您的系统上已经安装了 Python，uv 将在无需配置的情况下自动检测并使用它。此外，uv 还可以安装和管理 Python 版本。uv 会根据需要自动下载缺失的 Python 版本——您无需手动安装 Python 即可开始使用。
快速入门
安装最新版本的 Python
注意
Python 官方不发布可分发的二进制文件。因此，uv 使用来自 Astral python-build-standalone 项目的发行版。有关更多详细信息，请参阅 Python 发行版文档。
Python 安装完成后，uv 命令将自动使用它。uv 还会将安装的版本添加到您的 PATH 中。
默认情况下，uv 仅安装带版本号的可执行文件。若要安装 python 和 python3 可执行文件，请包含实验性的 --default 选项。
提示
有关更多详细信息，请参阅关于安装 Python 可执行文件的文档。
安装特定版本
安装特定的 Python 版本
安装多个 Python 版本
安装替代的 Python 实现（例如 PyPy）
$ uv python install [email protected]
有关更多详细信息，请参阅 python install 文档。
重新安装 Python
若要重新安装 uv 管理的 Python 版本，请使用 --reinstall，例如：
这将重新安装所有之前安装的 Python 版本。Python 发行版会不断进行改进，因此即使 Python 版本没有变化，重新安装也可能解决某些错误。
查看 Python 安装
查看可用和已安装的 Python 版本
有关更多详细信息，请参阅 python list 文档。
自动下载 Python
使用 uv 无需显式安装 Python。默认情况下，uv 会在需要时自动下载 Python 版本。例如，如果未安装 Python 3.12，以下命令将下载它：
$ uvx [email protected] -c "print('hello world')"
即使未指定特定的 Python 版本，uv 也会按需下载最新版本。例如，如果您的系统上没有任何 Python 版本，以下命令会在创建新的虚拟环境之前安装 Python：
提示
如果您希望更精细地控制 Python 的下载时机，可以轻松禁用自动下载功能。
使用现有的 Python 版本
如果您的系统上已存在 Python 安装，uv 将优先使用它们。此行为无需任何配置：如果系统 Python 满足命令调用的要求，uv 就会使用它。有关详细信息，请参阅 Python 发现文档。
若要强制 uv 使用系统 Python，请添加 --no-managed-python 标志。有关更多详细信息，请参阅 Python 版本偏好文档。
升级 Python 版本
重要
支持升级 Python 补丁版本的功能目前处于预览阶段。这意味着该行为是实验性的，可能会发生变化。
将 Python 版本升级到受支持的最新补丁版本
升级所有由 uv 管理的 Python 版本
有关更多详细信息，请参阅 python upgrade 文档。
下一步
若要了解有关 uv python 的更多信息，请参阅 Python 版本概念页面和命令行参考。
或者，请继续阅读以了解如何运行脚本并使用 uv 调用 Python。