环境变量

此变量可以设置为镜像 URL，以使用不同的 PyPy 安装源。提供的 URL 将替换 https://downloads.python.org/pypy，例如，在 https://downloads.python.org/pypy/pypy3.8-v7.3.7-osx64.tar.bz2 中。可以使用 file:// URL 方案从本地目录读取发行版。

`UV_PYTHON`

等同于 --python 命令行参数。如果设置为路径，uv 将对所有操作使用此 Python 解释器。

`UV_PYTHON_DOWNLOADS`

等同于 python-downloads 设置，以及在禁用时，--no-python-downloads 选项。uv 是否应允许 Python 下载。

`UV_PYTHON_DOWNLOADS_JSON_URL`

托管的 Python 安装信息硬编码在 uv 二进制文件中。

此变量可以设置为指向 JSON 的 URL，以用作 Python 安装列表。这将允许设置 Python 安装的每个属性，主要是用于离线镜像的 url 部分。

请注意，目前仅支持本地路径。

`UV_PYTHON_INSTALL_MIRROR`

托管的 Python 安装从 Astral python-build-standalone 项目下载。

此变量可以设置为镜像 URL，以使用不同的 Python 安装源。提供的 URL 将替换 https://github.com/astral-sh/python-build-standalone/releases/download，例如，在 https://github.com/astral-sh/python-build-standalone/releases/download/20240713/cpython-3.12.4%2B20240713-aarch64-apple-darwin-install_only.tar.gz 中。可以使用 file:// URL 方案从本地目录读取发行版。

`UV_PYTHON_PREFERENCE`

uv 是否应首选系统或托管的 Python 版本。

`UV_REQUEST_TIMEOUT`

HTTP 请求的超时时间（以秒为单位）。等同于 UV_HTTP_TIMEOUT。

`UV_REQUIRE_HASHES`

等同于 --require-hashes 命令行参数。如果设置为 true，uv 将要求所有依赖项在需求文件中都指定了哈希值。

`UV_RESOLUTION`

等同于 --resolution 命令行参数。例如，如果设置为 lowest-direct，uv 将安装所有直接依赖项的最低兼容版本。

`UV_STACK_SIZE`

用于设置 uv 使用的堆栈大小。

该值以字节为单位，如果 UV_STACK_SIZE 和 RUST_MIN_STACK 都未设置，uv 将使用 4MB (4194304) 的堆栈。UV_STACK_SIZE 优先于 RUST_MIN_STACK。

与正常的 RUST_MIN_STACK 语义不同，这可能会影响主线程堆栈大小，因为我们实际上生成了自己的 main2 线程来解决 Windows 真正的主线程只有 1MB 的问题。该线程的大小为 max(UV_STACK_SIZE, 1MB)。

`UV_SYSTEM_PYTHON`

等同于 --system 命令行参数。如果设置为 true，uv 将使用在系统 PATH 中找到的第一个 Python 解释器。

警告：UV_SYSTEM_PYTHON=true 旨在用于持续集成 (CI) 或容器化环境，应谨慎使用，因为修改系统 Python 可能导致意外行为。

`UV_TOOL_BIN_DIR`

指定用于安装工具可执行文件的“bin”目录。

`UV_TOOL_DIR`

指定 uv 存储托管工具的目录。

`UV_TORCH_BACKEND`

等同于 --torch-backend 命令行参数（例如，cpu、cu126 或 auto）。

`UV_UNMANAGED_INSTALL`

用于 CI 等临时环境，将 uv 安装到特定路径，同时防止安装程序修改 shell 配置文件或环境变量。

`UV_VENV_SEED`

将种子包（pip、setuptools 和 wheel 中的一个或多个）安装到 uv venv 创建的虚拟环境中。

请注意，setuptools 和 wheel 不包含在 Python 3.12+ 环境中。

外部定义变量

uv 还读取以下外部定义的环境变量：

`ACTIONS_ID_TOKEN_REQUEST_TOKEN`

用于通过 uv publish 进行可信发布。包含 oidc 请求令牌。

`ACTIONS_ID_TOKEN_REQUEST_URL`

用于通过 uv publish 进行可信发布。包含 oidc 令牌 url。

`ALL_PROXY`

所有网络请求的通用代理。

`APPDATA`

Windows 系统上用户级配置目录的路径。

`BASH_VERSION`

用于检测 Bash shell 的使用情况。

`CLICOLOR_FORCE`

用于通过 anstyle 控制颜色。

`COLUMNS`

覆盖用于换行的终端宽度。此变量不由 uv 直接读取。

这是一个准标准变量，例如在 ncurses(3x) 中有描述。

`CONDA_DEFAULT_ENV`

用于确定活动的 Conda 环境是否为基础环境。

`CONDA_PREFIX`

用于检测已激活的 Conda 环境。

`FISH_VERSION`

用于检测 Fish shell 的使用情况。

`FORCE_COLOR`

无论终端支持如何，都强制使用彩色输出。

请参阅 force-color.org。

`GITHUB_ACTIONS`

用于通过 uv publish 进行可信发布。

`HOME`

标准的 HOME 环境变量。

`HTTPS_PROXY`

HTTPS 请求的代理。

`HTTP_PROXY`

HTTP 请求的代理。

`HTTP_TIMEOUT`

HTTP 请求的超时时间（以秒为单位）。等同于 UV_HTTP_TIMEOUT。

`INSTALLER_NO_MODIFY_PATH`

在使用独立安装程序和 self update 功能安装 uv 时，避免修改 PATH 环境变量。

`JPY_SESSION_NAME`

用于检测在 Jupyter notebook 中运行的情况。

`KSH_VERSION`

用于检测 Ksh shell 的使用情况。

`LOCALAPPDATA`

用于查找 Microsoft Store Pythons 安装。

`MACOSX_DEPLOYMENT_TARGET`

与 --python-platform macos 及相关变体一起使用，以设置部署目标（即支持的最低 macOS 版本）。

默认为 13.0，即撰写本文时最新的非 EOL macOS 版本。

`NETRC`

用于设置 .netrc 文件的位置。

`NO_COLOR`

禁用彩色输出（优先于 FORCE_COLOR）。

请参阅 no-color.org。

`NU_VERSION`

用于检测 NuShell 的使用情况。

标准的 PAGER posix 环境变量。uv 使用它来配置适当的分页器。

`PATH`

标准的 PATH 环境变量。

`PROMPT`

用于检测 Windows 命令提示符（而不是 PowerShell）的使用情况。

`PWD`

标准的 PWD posix 环境变量。

`PYC_INVALIDATION_MODE`

与 --compile 一起运行时使用的验证模式。

请参阅 PycInvalidationMode。

`PYTHONPATH`

将目录添加到 Python 模块搜索路径（例如，PYTHONPATH=/path/to/modules）。

`RUST_LOG`

如果设置，uv 将使用此值作为其 --verbose 输出的日志级别。接受与 tracing_subscriber crate 兼容的任何过滤器。

例如：

RUST_LOG=uv=debug 等同于在命令行中添加 --verbose
RUST_LOG=trace 将启用跟踪级日志记录。

有关更多信息，请参阅 tracing 文档。

`RUST_MIN_STACK`

用于设置 uv 使用的堆栈大小。

该值以字节为单位，如果 UV_STACK_SIZE 和 RUST_MIN_STACK 都未设置，uv 将使用 4MB (4194304) 的堆栈。UV_STACK_SIZE 优先于 RUST_MIN_STACK。

建议设置 UV_STACK_SIZE，因为 RUST_MIN_STACK 也会影响子进程，例如使用 Rust 代码的构建后端。

与正常的 RUST_MIN_STACK 语义不同，这可能会影响主线程堆栈大小，因为我们实际上生成了自己的 main2 线程来解决 Windows 真正的主线程只有 1MB 的问题。该线程的大小为 max(RUST_MIN_STACK, 1MB)。

如果可执行文件是通过符号链接调用的，某些平台将返回符号链接的路径，而其他平台将返回符号链接目标的路径。

有关安全注意事项，请参阅 https://doc.rust-lang.org/std/env/fn.current_exe.html#security。