uv python

管理 Python 版本和安装。

通常，uv 首先在虚拟环境中搜索 Python，无论是活动的虚拟环境还是当前工作目录或任何父目录中的 .venv 目录。如果不需要虚拟环境，uv 将搜索 Python 解释器。通过在 PATH 环境变量中搜索 Python 可执行文件来找到 Python 解释器。

在 Windows 上，注册表也会被搜索以查找 Python 可执行文件。

默认情况下，如果找不到版本，uv 将下载 Python。可以使用 --no-python-downloads 标志或 python-downloads 设置来禁用此行为。

--python 选项允许请求不同的解释器。

支持以下 Python 版本请求格式：

<version> 例如 3、3.12、3.12.3
<version-specifier> 例如 >=3.12,<3.13
<implementation> 例如 cpython 或 cp
<implementation>@<version> 例如 cpython@3.12
<implementation><version> 例如 cpython3.12 或 cp312
<implementation><version-specifier> 例如 cpython>=3.12,<3.13
<implementation>-<version>-<os>-<arch>-<libc> 例如 cpython-3.12.3-macos-aarch64-none

此外，通常可以使用以下方式请求特定的系统 Python 解释器：

当使用 --python 选项时，正常的发现规则适用，但会检查发现的解释器是否与请求兼容，例如，如果请求 pypy，uv 将首先检查虚拟环境是否包含 PyPy 解释器，然后检查路径中的每个可执行文件是否为 PyPy 解释器。

uv 支持发现 CPython、PyPy 和 GraalPy 解释器。不支持的解释器将在发现过程中被跳过。如果请求不支持的解释器实现，uv 将退出并报错。

Usage

uv python [OPTIONS] <COMMAND>