环境变量

可以将此变量设置为镜像 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_BIN`

是否将 Python 可执行文件安装到 UV_PYTHON_BIN_DIR 目录中。

`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_INSTALL_REGISTRY`

是否将 Python 可执行文件安装到 Windows 注册表中。

`UV_PYTHON_PREFERENCE`

uv 是否应优先使用系统或托管的 Python 版本。

`UV_REQUEST_TIMEOUT`

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

`UV_REQUIRE_HASHES`

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

`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_TEST_NO_HTTP_RETRY_DELAY`

用于禁用测试中 HTTP 重试的延迟。

`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_CLEAR`

等效于 --clear 命令行参数。如果设置，uv 将删除目标路径中的任何现有文件或目录。

`UV_VENV_SEED`

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

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

外部定义的变量

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 笔记本中运行时。

`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 documentation。

`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.net.cn/std/env/fn.current_exe.html#security。