安装 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 下载
无需显式安装 Python 即可使用 uv。 默认情况下，uv 将在需要时自动下载 Python 版本。 例如，如果未安装 Python 3.12，则以下命令将下载它
$ uvx [email protected] -c "print('hello world')"
即使未请求特定的 Python 版本，uv 也会按需下载最新版本。 例如，如果您的系统上没有 Python 版本，则以下命令将在创建新虚拟环境之前安装 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。