uv cache

要求使用 uv 管理的 Python 版本 [env: UV_MANAGED_PYTHON=]

默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。

--no-cache, --no-cache-dir, -n

避免从缓存读取或写入缓存，而是在操作期间使用临时目录

也可通过 UV_NO_CACHE 环境变量设置。

避免发现配置文件（pyproject.toml、uv.toml）。

通常，配置文件会在当前目录、父目录或用户配置目录中被发现。

也可通过 UV_NO_CONFIG 环境变量设置。

禁用使用 uv 管理的 Python 版本 [env: UV_NO_MANAGED_PYTHON=]

相反，uv 将在系统上搜索合适的 Python 版本。

隐藏所有进度输出 [env: UV_NO_PROGRESS=]

例如，旋转动画或进度条。

禁用 Python 的自动下载。

禁用网络访问 [env: UV_OFFLINE=]

禁用后，uv 将仅使用本地缓存数据和本地可用文件。

--project project

在指定目录中发现项目。

所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来发现，项目的虚拟环境（.venv）也是如此。

其他命令行参数（如相对路径）将相对于当前工作目录进行解析。

如果要完全更改工作目录，请参阅 --directory。

此设置在 uv pip 接口中使用时无效。

也可通过 UV_PROJECT 环境变量设置。

--quiet, -q

使用静默输出。

重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向 stdout 写入任何输出。

是否从平台的原生证书存储加载 TLS 证书 [env: UV_SYSTEM_CERTS=]

默认情况下，uv 使用捆绑的 Mozilla 根证书，这提高了可移植性和性能（尤其是在 macOS 上）。

但是，在某些情况下，你可能希望使用平台的原生证书存储，特别是当你依赖系统证书存储中包含的企业信任根（例如用于强制代理）时。

--verbose, -v

使用详细输出。

你可以使用 RUST_LOG 环境变量配置细粒度的日志记录。（https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives）

uv cache prune

修剪缓存中所有不可达的对象

用法

uv cache prune [OPTIONS]

选项

--allow-insecure-host, --trusted-host allow-insecure-host

允许与主机的非安全连接。

可多次提供。

期望接收主机名（例如 localhost）、主机-端口对（例如 localhost:8080）或 URL（例如 https://localhost）。

警告：此列表中的主机将不会通过系统证书存储进行验证。仅在安全的网络环境中使用 --allow-insecure-host，并确保来源可信，因为此选项会绕过 SSL 验证，可能使你暴露于中间人攻击（MITM）的风险中。

也可通过 UV_INSECURE_HOST 环境变量设置。

--cache-dir cache-dir

缓存目录的路径。

默认在 macOS 和 Linux 上为 $XDG_CACHE_HOME/uv 或 $HOME/.cache/uv，在 Windows 上为 %LOCALAPPDATA%\uv\cache。

要查看缓存目录的位置，请运行 uv cache dir。

也可通过 UV_CACHE_DIR 环境变量设置。

--ci

优化缓存以在持续集成环境（如 GitHub Actions）中持久化。

默认情况下，uv 会同时缓存从源码构建的 wheel 和直接下载的预构建 wheel，以实现高性能的包安装。但在某些场景下，持久化预构建 wheel 可能并不理想。例如，在 GitHub Actions 中，从缓存中省略预构建 wheel 并在每次运行时重新下载它们会更快。然而，缓存从源码构建的 wheel 通常会更快，因为 wheel 构建过程可能很昂贵，尤其是对于扩展模块。

在 --ci 模式下，uv 将从缓存中修剪所有预构建的 wheel，但保留所有从源码构建的 wheel。

--color color-choice

控制输出中颜色的使用。

默认情况下，uv 会在写入终端时自动检测是否支持颜色。

可选值：

auto：仅当输出到支持颜色的终端或 TTY 时启用彩色输出
always：无论检测到的环境如何，均启用彩色输出
never：禁用彩色输出

--config-file config-file

用于配置的 uv.toml 文件路径。

虽然 uv 配置可以包含在 pyproject.toml 文件中，但在此上下文中不允许这样做。

也可通过 UV_CONFIG_FILE 环境变量设置。

--directory directory

在运行命令之前切换到指定目录。

相对路径以该目录为基准进行解析。

如果只想更改项目根目录，请参阅 --project。

也可通过 UV_WORKING_DIR 环境变量设置。

--force

强制移除缓存，忽略使用中检查。

默认情况下，uv cache prune 会阻塞直到没有进程正在读取缓存。使用 --force 时，uv cache prune 将在不获取锁的情况下继续执行。

--help, -h

显示此命令的简明帮助信息

要求使用 uv 管理的 Python 版本 [env: UV_MANAGED_PYTHON=]

默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。

--no-cache, --no-cache-dir, -n

避免从缓存读取或写入缓存，而是在操作期间使用临时目录

也可通过 UV_NO_CACHE 环境变量设置。

避免发现配置文件（pyproject.toml、uv.toml）。

通常，配置文件会在当前目录、父目录或用户配置目录中被发现。

也可通过 UV_NO_CONFIG 环境变量设置。

禁用使用 uv 管理的 Python 版本 [env: UV_NO_MANAGED_PYTHON=]

相反，uv 将在系统上搜索合适的 Python 版本。

隐藏所有进度输出 [env: UV_NO_PROGRESS=]

例如，旋转动画或进度条。

禁用 Python 的自动下载。

禁用网络访问 [env: UV_OFFLINE=]

禁用后，uv 将仅使用本地缓存数据和本地可用文件。

--project project

在指定目录中发现项目。

所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来发现，项目的虚拟环境（.venv）也是如此。

其他命令行参数（如相对路径）将相对于当前工作目录进行解析。

如果要完全更改工作目录，请参阅 --directory。

此设置在 uv pip 接口中使用时无效。

也可通过 UV_PROJECT 环境变量设置。

--quiet, -q

使用静默输出。

重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向 stdout 写入任何输出。

是否从平台的原生证书存储加载 TLS 证书 [env: UV_SYSTEM_CERTS=]

默认情况下，uv 使用捆绑的 Mozilla 根证书，这提高了可移植性和性能（尤其是在 macOS 上）。

但是，在某些情况下，你可能希望使用平台的原生证书存储，特别是当你依赖系统证书存储中包含的企业信任根（例如用于强制代理）时。

--verbose, -v

使用详细输出。

你可以使用 RUST_LOG 环境变量配置细粒度的日志记录。（https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives）

uv cache dir

显示缓存目录。

默认情况下，缓存在 Unix 上存储在 $XDG_CACHE_HOME/uv 或 $HOME/.cache/uv 中，在 Windows 上存储在 %LOCALAPPDATA%\uv\cache 中。

当使用 --no-cache 时，缓存存储在临时目录中，并在进程退出时丢弃。

可以通过 cache-dir 设置、--cache-dir 选项或 $UV_CACHE_DIR 环境变量指定替代的缓存目录。

请注意，为了获得最佳性能，缓存目录应与 uv 正在操作的 Python 环境位于同一文件系统上。

用法

uv cache dir [OPTIONS]

选项

--allow-insecure-host, --trusted-host allow-insecure-host

允许与主机的非安全连接。

可多次提供。

期望接收主机名（例如 localhost）、主机-端口对（例如 localhost:8080）或 URL（例如 https://localhost）。

警告：此列表中的主机将不会通过系统证书存储进行验证。仅在安全的网络环境中使用 --allow-insecure-host，并确保来源可信，因为此选项会绕过 SSL 验证，可能使你暴露于中间人攻击（MITM）的风险中。

也可通过 UV_INSECURE_HOST 环境变量设置。

--cache-dir cache-dir

缓存目录的路径。

默认在 macOS 和 Linux 上为 $XDG_CACHE_HOME/uv 或 $HOME/.cache/uv，在 Windows 上为 %LOCALAPPDATA%\uv\cache。

要查看缓存目录的位置，请运行 uv cache dir。

也可通过 UV_CACHE_DIR 环境变量设置。

--color color-choice

控制输出中颜色的使用。

默认情况下，uv 会在写入终端时自动检测是否支持颜色。

可选值：

auto：仅当输出到支持颜色的终端或 TTY 时启用彩色输出
always：无论检测到的环境如何，均启用彩色输出
never：禁用彩色输出

--config-file config-file

用于配置的 uv.toml 文件路径。

虽然 uv 配置可以包含在 pyproject.toml 文件中，但在此上下文中不允许这样做。

也可通过 UV_CONFIG_FILE 环境变量设置。

--directory directory

在运行命令之前切换到指定目录。

相对路径以该目录为基准进行解析。

如果只想更改项目根目录，请参阅 --project。

也可通过 UV_WORKING_DIR 环境变量设置。

--help, -h

显示此命令的简明帮助信息

要求使用 uv 管理的 Python 版本 [env: UV_MANAGED_PYTHON=]

默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。

--no-cache, --no-cache-dir, -n

避免从缓存读取或写入缓存，而是在操作期间使用临时目录

也可通过 UV_NO_CACHE 环境变量设置。

避免发现配置文件（pyproject.toml、uv.toml）。

通常，配置文件会在当前目录、父目录或用户配置目录中被发现。

也可通过 UV_NO_CONFIG 环境变量设置。

禁用使用 uv 管理的 Python 版本 [env: UV_NO_MANAGED_PYTHON=]

相反，uv 将在系统上搜索合适的 Python 版本。

隐藏所有进度输出 [env: UV_NO_PROGRESS=]

例如，旋转动画或进度条。

禁用 Python 的自动下载。

禁用网络访问 [env: UV_OFFLINE=]

禁用后，uv 将仅使用本地缓存数据和本地可用文件。

--project project

在指定目录中发现项目。

所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来发现，项目的虚拟环境（.venv）也是如此。

其他命令行参数（如相对路径）将相对于当前工作目录进行解析。

如果要完全更改工作目录，请参阅 --directory。

此设置在 uv pip 接口中使用时无效。

也可通过 UV_PROJECT 环境变量设置。

--quiet, -q

使用静默输出。

重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向 stdout 写入任何输出。

是否从平台的原生证书存储加载 TLS 证书 [env: UV_SYSTEM_CERTS=]

默认情况下，uv 使用捆绑的 Mozilla 根证书，这提高了可移植性和性能（尤其是在 macOS 上）。

但是，在某些情况下，你可能希望使用平台的原生证书存储，特别是当你依赖系统证书存储中包含的企业信任根（例如用于强制代理）时。

--verbose, -v

使用详细输出。

你可以使用 RUST_LOG 环境变量配置细粒度的日志记录。（https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives）

uv cache size

显示缓存大小。

显示缓存目录的总大小。这包括所有已下载和已构建的 wheel、源码分发包（source distributions）以及其他缓存数据。默认情况下，以原始字节数输出大小；使用 --human 可获得人类可读的输出。

用法

uv cache size [OPTIONS]

选项

--allow-insecure-host, --trusted-host allow-insecure-host

允许与主机的非安全连接。

可多次提供。

期望接收主机名（例如 localhost）、主机-端口对（例如 localhost:8080）或 URL（例如 https://localhost）。

警告：此列表中的主机将不会通过系统证书存储进行验证。仅在安全的网络环境中使用 --allow-insecure-host，并确保来源可信，因为此选项会绕过 SSL 验证，可能使你暴露于中间人攻击（MITM）的风险中。

也可通过 UV_INSECURE_HOST 环境变量设置。

--cache-dir cache-dir

缓存目录的路径。

默认在 macOS 和 Linux 上为 $XDG_CACHE_HOME/uv 或 $HOME/.cache/uv，在 Windows 上为 %LOCALAPPDATA%\uv\cache。

要查看缓存目录的位置，请运行 uv cache dir。

也可通过 UV_CACHE_DIR 环境变量设置。

--color color-choice

控制输出中颜色的使用。

默认情况下，uv 会在写入终端时自动检测是否支持颜色。

可选值：

auto：仅当输出到支持颜色的终端或 TTY 时启用彩色输出
always：无论检测到的环境如何，均启用彩色输出
never：禁用彩色输出

--config-file config-file

用于配置的 uv.toml 文件路径。

虽然 uv 配置可以包含在 pyproject.toml 文件中，但在此上下文中不允许这样做。

也可通过 UV_CONFIG_FILE 环境变量设置。

--directory directory

在运行命令之前切换到指定目录。

相对路径以该目录为基准进行解析。

如果只想更改项目根目录，请参阅 --project。

也可通过 UV_WORKING_DIR 环境变量设置。

--help, -h

显示此命令的简明帮助信息

--human, --human-readable, -H

以人类可读的格式显示缓存大小（例如 1.2 GiB 而非原始字节数）

要求使用 uv 管理的 Python 版本 [env: UV_MANAGED_PYTHON=]

默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。

--no-cache, --no-cache-dir, -n

避免从缓存读取或写入缓存，而是在操作期间使用临时目录

也可通过 UV_NO_CACHE 环境变量设置。

避免发现配置文件（pyproject.toml、uv.toml）。

通常，配置文件会在当前目录、父目录或用户配置目录中被发现。

也可通过 UV_NO_CONFIG 环境变量设置。

禁用使用 uv 管理的 Python 版本 [env: UV_NO_MANAGED_PYTHON=]

相反，uv 将在系统上搜索合适的 Python 版本。

隐藏所有进度输出 [env: UV_NO_PROGRESS=]

例如，旋转动画或进度条。

禁用 Python 的自动下载。

禁用网络访问 [env: UV_OFFLINE=]

禁用后，uv 将仅使用本地缓存数据和本地可用文件。

--project project

在指定目录中发现项目。

所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来发现，项目的虚拟环境（.venv）也是如此。

其他命令行参数（如相对路径）将相对于当前工作目录进行解析。

如果要完全更改工作目录，请参阅 --directory。

此设置在 uv pip 接口中使用时无效。

也可通过 UV_PROJECT 环境变量设置。

--quiet, -q

使用静默输出。

重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向 stdout 写入任何输出。