--all-arches, --all_architectures列出所有架构的 Python 下载信息。
默认情况下，仅显示当前架构的下载信息。
--all-platforms列出所有平台的 Python 下载信息。
默认情况下，仅显示当前平台的下载信息。
--all-versions列出所有 Python 版本，包括旧的补丁版本。
默认情况下，每个次版本仅显示最新的补丁版本。
--allow-insecure-host, --trusted-host allow-insecure-host允许与主机建立不安全连接。
可多次提供此选项。
预期接收主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它绕过了 SSL 验证，可能使您面临中间人攻击。
也可以通过 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 仅更改项目根目录。
--help, -h显示此命令的简要帮助
--managed-python要求使用 uv 管理的 Python 版本。
默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。
也可以通过 UV_MANAGED_PYTHON 环境变量设置。
--native-tls是否从平台的本机证书存储加载 TLS 证书。
默认情况下，uv 从捆绑的 webpki-roots 库加载证书。webpki-roots 是一组来自 Mozilla 的可靠信任根，将它们包含在 uv 中可提高可移植性和性能（尤其是在 macOS 上）。
但是，在某些情况下，您可能希望使用平台的本机证书存储，特别是如果您依赖于包含在系统证书存储中的企业信任根（例如，用于强制代理）。
也可以通过 UV_NATIVE_TLS 环境变量设置。
--no-cache, --no-cache-dir, -n避免读取或写入缓存，而是在操作期间使用临时目录
也可以通过 UV_NO_CACHE 环境变量设置。
--no-config避免查找配置文件（pyproject.toml、uv.toml）。
通常，配置文件会在当前目录、父目录或用户配置目录中查找。
也可以通过 UV_NO_CONFIG 环境变量设置。
--no-managed-python禁用使用 uv 管理的 Python 版本。
相反，uv 将在系统上搜索合适的 Python 版本。
也可以通过 UV_NO_MANAGED_PYTHON 环境变量设置。
--no-progress隐藏所有进度输出。
例如，旋转器或进度条。
也可以通过 UV_NO_PROGRESS 环境变量设置。
--no-python-downloads禁用 Python 的自动下载。
--offline禁用网络访问。
禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。
也可以通过 UV_OFFLINE 环境变量设置。
--only-downloads仅显示可用的 Python 下载信息。
默认情况下，会显示当前平台上已安装的发行版和可用的下载信息。
--only-installed仅显示已安装的 Python 版本。
默认情况下，会显示当前平台上已安装的发行版和可用的下载信息。
--output-format output-format选择输出格式
[默认值：text]
可能的值：
text：纯文本（供人阅读）json：JSON（供计算机使用）
--project project在指定的项目目录中运行命令。
所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来查找，项目的虚拟环境（.venv）也是如此。
其他命令行参数（如相对路径）将相对于当前工作目录进行解析。
请参阅 --directory 以完全更改工作目录。
此设置在 uv pip 接口中使用时无效。
也可以通过 UV_PROJECT 环境变量设置。
--python-downloads-json-url python-downloads-json-url指向自定义 Python 安装的 JSON 文件的 URL。
请注意，目前仅支持本地路径。
也可以通过 UV_PYTHON_DOWNLOADS_JSON_URL 环境变量设置。
--quiet, -q使用安静输出。
重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向标准输出写入任何内容。
--show-urls显示可用 Python 下载的 URL。
默认情况下，这些显示为 <download available>。
--verbose, -v使用详细输出。
您可以使用 RUST_LOG 环境变量配置细粒度的日志记录。（
### uv python install
下载并安装 Python 版本。
支持 CPython 和 PyPy。CPython 发行版从 Astral 的 `python-build-standalone` 项目下载。PyPy 发行版从 `python.org` 下载。每个 uv 版本都捆绑了可用的 Python 版本。若要安装新的 Python 版本，可能需要升级 uv。
Python 版本安装到 uv Python 目录中，可使用 `uv python dir` 命令获取该目录。
不会全局提供 `python` 可执行文件，uv 管理的 Python 版本仅在 uv 命令或活动的虚拟环境中使用。目前有将 Python 可执行文件添加到 `PATH` 的实验性支持，使用 `--preview` 标志可启用此功能。
可以请求安装多个 Python 版本。
请查看 `uv help python` 以了解支持的请求格式。
--allow-insecure-host, --trusted-host allow-insecure-host允许与主机建立不安全连接。
可以多次提供此选项。
接受主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它绕过了 SSL 验证，可能使您遭受中间人攻击。
也可以通过 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 环境变量设置。
--default用作默认的 Python 版本。
默认情况下，仅安装 python{major}.{minor} 可执行文件，例如 python3.10。使用 --default 标志时，还会安装 python{major}（例如 python3）和 python 可执行文件。
其他 Python 变体仍将包含其标记。例如，使用 --default 安装 3.13+freethreaded 版本，将包含 python3t 和 pythont，而不是 python3 和 python。
如果请求安装多个 Python 版本，uv 将报错退出。
--directory directory在运行命令之前切换到指定目录。
相对路径将以指定目录为基础进行解析。
请查看 --project 以仅更改项目根目录。
--force, -f在安装过程中替换现有的 Python 可执行文件。
默认情况下，uv 将拒绝替换它不管理的可执行文件。
隐含 --reinstall。
--help, -h显示此命令的简要帮助
--install-dir, -i install-dir存储 Python 安装文件的目录。
如果提供此选项，则需要设置 UV_PYTHON_INSTALL_DIR，以便 uv 在后续操作中发现 Python 安装。
请查看 uv python dir 以查看当前的 Python 安装目录。默认值为 ~/.local/share/uv/python。
也可以通过 UV_PYTHON_INSTALL_DIR 环境变量设置。
--managed-python要求使用 uv 管理的 Python 版本。
默认情况下，uv 优先使用它管理的 Python 版本。但是，如果未安装 uv 管理的 Python 版本，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。
也可以通过 UV_MANAGED_PYTHON 环境变量设置。
--mirror mirror设置用于下载 Python 安装文件的源 URL。
提供的 URL 将替换例如 https://github.com/astral-sh/python-build-standalone/releases/download/20240713/cpython-3.12.4%2B20240713-aarch64-apple-darwin-install_only.tar.gz 中的 https://github.com/astral-sh/python-build-standalone/releases/download。
可以使用 file:// URL 方案从本地目录读取发行版。
也可以通过 UV_PYTHON_INSTALL_MIRROR 环境变量设置。
--native-tls是否从平台的本地证书存储加载 TLS 证书。
默认情况下，uv 从捆绑的 webpki-roots 库加载证书。webpki-roots 是一组来自 Mozilla 的可靠信任根，将它们包含在 uv 中可提高可移植性和性能（特别是在 macOS 上）。
但是，在某些情况下，您可能希望使用平台的本地证书存储，尤其是当您依赖包含在系统证书存储中的企业信任根（例如，用于强制代理）时。
也可以通过 UV_NATIVE_TLS 环境变量设置。
--no-cache, --no-cache-dir, -n避免读取或写入缓存，而是在操作期间使用临时目录。
也可以通过 UV_NO_CACHE 环境变量设置。
--no-config避免查找配置文件（pyproject.toml、uv.toml）。
通常，配置文件会在当前目录、父目录或用户配置目录中查找。
也可以通过 UV_NO_CONFIG 环境变量设置。
--no-managed-python禁用使用 uv 管理的 Python 版本。
相反，uv 将在系统中搜索合适的 Python 版本。
也可以通过 UV_NO_MANAGED_PYTHON 环境变量设置。
--no-progress隐藏所有进度输出。
例如，旋转器或进度条。
也可以通过 UV_NO_PROGRESS 环境变量设置。
--no-python-downloads禁用 Python 的自动下载。
--offline禁用网络访问。
禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。
也可以通过 UV_OFFLINE 环境变量设置。
--project project在指定的项目目录中运行命令。
所有 pyproject.toml、uv.toml 和 .python-version 文件将从项目根目录向上遍历目录树来查找，项目的虚拟环境（.venv）也是如此。
其他命令行参数（如相对路径）将相对于当前工作目录进行解析。
请查看 --directory 以完全更改工作目录。
此设置在 uv pip 接口中使用时无效。
也可以通过 UV_PROJECT 环境变量设置。
--pypy-mirror pypy-mirror设置用于下载 PyPy 安装文件的源 URL。
提供的 URL 将替换例如 https://downloads.python.org/pypy/pypy3.8-v7.3.7-osx64.tar.bz2 中的 https://downloads.python.org/pypy。
可以使用 file:// URL 方案从本地目录读取发行版。
也可以通过 UV_PYPY_INSTALL_MIRROR 环境变量设置。
--python-downloads-json-url python-downloads-json-url指向自定义 Python 安装的 JSON 文件的 URL。
请注意，目前仅支持本地路径。
也可以通过 UV_PYTHON_DOWNLOADS_JSON_URL 环境变量设置。
--quiet, -q使用安静输出。
重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向标准输出写入任何内容。
--reinstall, -r重新安装请求的 Python 版本（如果已安装）。
默认情况下，如果版本已安装，uv 将成功退出。
--verbose, -v使用详细输出。
您可以使用 RUST_LOG 环境变量配置细粒度的日志记录。（）
### uv python find
搜索 Python 安装路径。
显示 Python 可执行文件的路径。
请参阅 `uv help python` 以查看支持的请求格式以及发现行为的详细信息。
--allow-insecure-host, --trusted-host allow-insecure-host允许与主机建立不安全连接。
可以多次提供。
预期接收主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它会绕过 SSL 验证，可能使您面临中间人攻击。
也可以通过 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 以仅更改项目根目录。
--help, -h显示此命令的简要帮助
--managed-python要求使用 uv 管理的 Python 版本。
默认情况下，uv 优先使用它管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。
也可以通过 UV_MANAGED_PYTHON 环境变量设置。
--native-tls是否从平台的本机证书存储加载 TLS 证书。
默认情况下，uv 从捆绑的 webpki-roots 库加载证书。webpki-roots 是来自 Mozilla 的一组可靠信任根，将它们包含在 uv 中可提高可移植性和性能（尤其是在 macOS 上）。
但是，在某些情况下，您可能希望使用平台的本机证书存储，特别是如果您依赖于包含在系统证书存储中的企业信任根（例如，用于强制代理）。
也可以通过 UV_NATIVE_TLS 环境变量设置。
--no-cache, --no-cache-dir, -n避免读取或写入缓存，而是在操作期间使用临时目录
也可以通过 UV_NO_CACHE 环境变量设置。
--no-config避免发现配置文件（pyproject.toml、uv.toml）。
通常，配置文件会在当前目录、父目录或用户配置目录中被发现。
也可以通过 UV_NO_CONFIG 环境变量设置。
--no-managed-python禁用使用 uv 管理的 Python 版本。
相反，uv 将在系统上搜索合适的 Python 版本。
也可以通过 UV_NO_MANAGED_PYTHON 环境变量设置。
--no-progress隐藏所有进度输出。
例如，旋转器或进度条。
也可以通过 UV_NO_PROGRESS 环境变量设置。
--no-project, --no_workspace避免发现项目或工作区。
否则，当未提供请求时，将使用当前目录或父目录中项目的 Python 要求。
--no-python-downloads禁用 Python 的自动下载。
--offline禁用网络访问。
禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。
也可以通过 UV_OFFLINE 环境变量设置。
--project project在给定的项目目录中运行命令。
所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来发现，项目的虚拟环境（.venv）也是如此。
其他命令行参数（如相对路径）将相对于当前工作目录进行解析。
请参阅 --directory 以完全更改工作目录。
此设置在 uv pip 接口中使用时无效。
也可以通过 UV_PROJECT 环境变量设置。
--quiet, -q使用安静输出。
重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向标准输出写入任何内容。
--script script查找 Python 脚本的环境，而不是当前项目的环境
--show-version显示将使用的 Python 版本，而不是解释器的路径
--system仅查找系统 Python 解释器。
默认情况下，uv 将报告它将使用的第一个 Python 解释器，包括活动虚拟环境或当前工作目录或任何父目录中的虚拟环境中的解释器。
--system 选项指示 uv 跳过虚拟环境 Python 解释器，并将其搜索限制在系统路径中。
也可以通过 UV_SYSTEM_PYTHON 环境变量设置。
--verbose, -v使用详细输出。
您可以使用 RUST_LOG 环境变量配置细粒度日志记录。（<https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives>）
### uv python pin
固定到特定的 Python 版本。
将固定的 Python 版本写入 `.python-version` 文件，其他 uv 命令会使用该文件来确定所需的 Python 版本。
如果未提供版本，uv 将查找现有的 `.python-version` 文件并显示当前固定的版本。如果未找到 `.python-version` 文件，uv 将报错退出。
请参阅 `uv help python` 以查看支持的请求格式。
--allow-insecure-host, --trusted-host allow-insecure-host允许对主机进行不安全连接。
可以多次提供。
预期接收主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它绕过了 SSL 验证，可能会使您遭受中间人攻击。
也可以通过 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 以仅更改项目根目录。
--global更新全局 Python 版本固定设置。
将固定的 Python 版本写入 uv 用户配置目录中的 .python-version 文件：在 Linux/macOS 上为 XDG_CONFIG_HOME/uv，在 Windows 上为 %APPDATA%/uv。
当在工作目录或其上级目录中未找到本地 Python 版本固定设置时，将改用此版本。
与本地版本固定设置不同，此版本用作更改全局状态的命令（如 uv tool install）的默认值。
--help, -h显示此命令的简要帮助
--managed-python要求使用 uv 管理的 Python 版本。
默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。
也可以通过 UV_MANAGED_PYTHON 环境变量设置。
--native-tls是否从平台的本机证书存储加载 TLS 证书。
默认情况下，uv 从捆绑的 webpki-roots 包加载证书。webpki-roots 是来自 Mozilla 的一组可靠信任根，将它们包含在 uv 中可提高可移植性和性能（尤其是在 macOS 上）。
但是，在某些情况下，您可能希望使用平台的本机证书存储，特别是如果您依赖于包含在系统证书存储中的企业信任根（例如，用于强制使用的代理）。
也可以通过 UV_NATIVE_TLS 环境变量设置。
--no-cache, --no-cache-dir, -n避免读取或写入缓存，而是在操作期间使用临时目录
也可以通过 UV_NO_CACHE 环境变量设置。
--no-config避免查找配置文件（pyproject.toml、uv.toml）。
通常，配置文件会在当前目录、父目录或用户配置目录中查找。
也可以通过 UV_NO_CONFIG 环境变量设置。
--no-managed-python禁用 uv 管理的 Python 版本的使用。
相反，uv 将在系统上搜索合适的 Python 版本。
也可以通过 UV_NO_MANAGED_PYTHON 环境变量设置。
--no-progress隐藏所有进度输出。
例如，旋转器或进度条。
也可以通过 UV_NO_PROGRESS 环境变量设置。
--no-project, --no-workspace避免验证 Python 固定设置是否与项目或工作区兼容。
默认情况下，会在当前目录或任何父目录中查找项目或工作区。如果找到工作区，将根据工作区的 requires-python 约束验证 Python 固定设置。
--no-python-downloads禁用 Python 的自动下载。
--offline禁用网络访问。
禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。
也可以通过 UV_OFFLINE 环境变量设置。
--project project在指定的项目目录中运行命令。
所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来查找，项目的虚拟环境（.venv）也是如此。
其他命令行参数（如相对路径）将相对于当前工作目录进行解析。
请参阅 --directory 以完全更改工作目录。
此设置在 uv pip 接口中使用时无效。
也可以通过 UV_PROJECT 环境变量设置。
--quiet, -q使用安静输出。
重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向标准输出写入任何内容。
--resolved写入已解析的 Python 解释器路径，而不是请求。
确保使用完全相同的解释器。
在将 .python-version 文件提交到版本控制时，此选项通常不安全。
--verbose, -v使用详细输出。
您可以使用 RUST_LOG 环境变量配置细粒度的日志记录。（<https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives>）
### uv Python 目录
显示 uv Python 安装目录。
默认情况下，Python 安装文件存储在 uv 数据目录中，在 Unix 系统上为 `$XDG_DATA_HOME/uv/python` 或 `$HOME/.local/share/uv/python`，在 Windows 系统上为 `%APPDATA%\uv\data\python`。
Python 安装目录可以通过 `$UV_PYTHON_INSTALL_DIR` 进行覆盖。
若要查看 uv 安装 Python 可执行文件的目录，请使用 `--bin` 标志。请注意，只有在启用预览模式时才会安装 Python 可执行文件。
--allow-insecure-host, --trusted-host allow-insecure-host允许与主机建立不安全连接。
可以多次提供。
接受主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它绕过了 SSL 验证，可能会使您遭受中间人攻击。
也可以通过 UV_INSECURE_HOST 环境变量设置。
--bin显示 uv python 将安装 Python 可执行文件的目录。
请注意，仅在启用预览模式安装 Python 时才使用此目录。
Python 可执行文件目录是根据 XDG 标准确定的，优先顺序如下，从以下环境变量派生而来：
$UV_PYTHON_BIN_DIR$XDG_BIN_HOME$XDG_DATA_HOME/../bin$HOME/.local/bin
--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 仅更改项目根目录。
--help, -h显示此命令的简要帮助
--managed-python要求使用 uv 管理的 Python 版本。
默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。
也可以通过 UV_MANAGED_PYTHON 环境变量设置。
--native-tls是否从平台的本机证书存储加载 TLS 证书。
默认情况下，uv 从捆绑的 webpki-roots 箱中加载证书。webpki-roots 是来自 Mozilla 的一组可靠的信任根，将它们包含在 uv 中可提高可移植性和性能（尤其是在 macOS 上）。
但是，在某些情况下，您可能希望使用平台的本机证书存储，特别是如果您依赖于包含在系统证书存储中的公司信任根（例如，用于强制代理）。
也可以通过 UV_NATIVE_TLS 环境变量设置。
--no-cache, --no-cache-dir, -n避免读取或写入缓存，而是在操作期间使用临时目录
也可以通过 UV_NO_CACHE 环境变量设置。
--no-config避免查找配置文件（pyproject.toml、uv.toml）。
通常，配置文件在当前目录、父目录或用户配置目录中查找。
也可以通过 UV_NO_CONFIG 环境变量设置。
--no-managed-python禁用使用 uv 管理的 Python 版本。
相反，uv 将在系统上搜索合适的 Python 版本。
也可以通过 UV_NO_MANAGED_PYTHON 环境变量设置。
--no-progress隐藏所有进度输出。
例如，旋转器或进度条。
也可以通过 UV_NO_PROGRESS 环境变量设置。
--no-python-downloads禁用 Python 的自动下载。
--offline禁用网络访问。
禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。
也可以通过 UV_OFFLINE 环境变量设置。
--project project在给定的项目目录中运行命令。
所有 pyproject.toml、uv.toml 和 .python-version 文件将从项目根目录向上遍历目录树进行查找，项目的虚拟环境（.venv）也是如此。
其他命令行参数（如相对路径）将相对于当前工作目录进行解析。
请参阅 --directory 以完全更改工作目录。
此设置在 uv pip 接口中使用时无效。
也可以通过 UV_PROJECT 环境变量设置。
--quiet, -q使用安静输出。
重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向标准输出写入任何内容。
--verbose, -v使用详细输出。
您可以使用 RUST_LOG 环境变量配置细粒度日志记录。（）
### uv python uninstall
卸载 Python 版本
--all卸载所有由 uv 管理的 Python 版本
--allow-insecure-host, --trusted-host allow-insecure-host允许与主机建立不安全连接。
可以多次提供。
预期接收主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它绕过了 SSL 验证，可能会使您遭受中间人攻击。
也可以通过 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 仅更改项目根目录。
--help, -h显示此命令的简要帮助
--install-dir, -i install-dirPython 安装到的目录
也可以通过 UV_PYTHON_INSTALL_DIR 环境变量设置。
--managed-python要求使用 uv 管理的 Python 版本。
默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。
也可以通过 UV_MANAGED_PYTHON 环境变量设置。
--native-tls是否从平台的本机证书存储加载 TLS 证书。
默认情况下，uv 从捆绑的 webpki-roots 库加载证书。webpki-roots 是来自 Mozilla 的一组可靠的信任根，将它们包含在 uv 中可提高可移植性和性能（尤其是在 macOS 上）。
但是，在某些情况下，您可能希望使用平台的本机证书存储，特别是如果您依赖于包含在系统证书存储中的企业信任根（例如，用于强制代理）。
也可以通过 UV_NATIVE_TLS 环境变量设置。
--no-cache, --no-cache-dir, -n避免读取或写入缓存，而是在操作期间使用临时目录
也可以通过 UV_NO_CACHE 环境变量设置。
--no-config避免查找配置文件（pyproject.toml、uv.toml）。
通常，配置文件会在当前目录、父目录或用户配置目录中查找。
也可以通过 UV_NO_CONFIG 环境变量设置。
--no-managed-python禁用 uv 管理的 Python 版本的使用。
相反，uv 将在系统上搜索合适的 Python 版本。
也可以通过 UV_NO_MANAGED_PYTHON 环境变量设置。
--no-progress隐藏所有进度输出。
例如，旋转器或进度条。
也可以通过 UV_NO_PROGRESS 环境变量设置。
--no-python-downloads禁用 Python 的自动下载。
--offline禁用网络访问。
禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。
也可以通过 UV_OFFLINE 环境变量设置。
--project project在给定的项目目录中运行命令。
所有 pyproject.toml、uv.toml 和 .python-version 文件将从项目根目录向上遍历目录树来查找，项目的虚拟环境（.venv）也是如此。
其他命令行参数（如相对路径）将相对于当前工作目录进行解析。
请参阅 --directory 以完全更改工作目录。
此设置在 uv pip 接口中使用时无效。
也可以通过 UV_PROJECT 环境变量设置。
--quiet, -q使用安静输出。
重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向标准输出写入任何内容。
--verbose, -v使用详细输出。
您可以使用 RUST_LOG 环境变量配置细粒度日志记录。（<https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives>）
## uv pip
通过与pip兼容的接口管理Python包
### 用法
包含所有可选依赖项。
仅适用于 pyproject.toml、setup.py 和 setup.cfg 源文件。
--allow-insecure-host, --trusted-host allow-insecure-host允许与主机建立不安全连接。
可以多次提供。
预期接收主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机将不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它绕过了 SSL 验证，可能会使您遭受中间人攻击。
也可以通过 UV_INSECURE_HOST 环境变量设置。
--annotation-style annotation-style输出文件中包含的注释样式，用于指示每个软件包的来源。
默认值为 split。
可能的值：
line：将注释呈现在单个逗号分隔的行上split：将每个注释呈现在自己的行上
--build-constraints, --build-constraint, -b build-constraints在构建源发行版时，使用给定的需求文件约束构建依赖项。
约束文件类似于 requirements.txt 文件，仅控制安装的需求的 版本。但是，在约束文件中包含一个软件包 不会 触发该软件包的安装。
也可以通过 UV_BUILD_CONSTRAINT 环境变量设置。
--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 环境变量设置。
--config-setting, --config-settings, -C config-setting传递给 PEP 517 构建后端的设置，指定为 KEY=VALUE 对
--constraints, --constraint, -c constraints使用给定的需求文件约束版本。
约束文件类似于 requirements.txt 文件，仅控制安装的需求的 版本。但是，在约束文件中包含一个软件包 不会 触发该软件包的安装。
这相当于 pip 的 --constraint 选项。
也可以通过 UV_CONSTRAINT 环境变量设置。
--custom-compile-command custom-compile-commanduv pip compile 生成的输出文件顶部包含的头部注释。
用于反映包装 uv pip compile 的自定义构建脚本和命令。
也可以通过 UV_CUSTOM_COMPILE_COMMAND 环境变量设置。
--default-index default-index默认软件包索引的 URL（默认值：）。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
此标志给出的索引的优先级低于通过 --index 标志指定的所有其他索引。
也可以通过 UV_DEFAULT_INDEX 环境变量设置。
--directory directory在运行命令之前切换到给定目录。
相对路径以给定目录为基础进行解析。
请参阅 --project 仅更改项目根目录。
--emit-build-options在生成的输出文件中包含 --no-binary 和 --only-binary 条目
--emit-find-links在生成的输出文件中包含 --find-links 条目
--emit-index-annotation包含注释，指示用于解析每个软件包的索引（例如 # from https://pypi.org/simple）
--emit-index-url在生成的输出文件中包含 --index-url 和 --extra-index-url 条目
--exclude-newer exclude-newer将候选软件包限制为在给定日期之前上传的软件包。
接受 RFC 3339 时间戳（例如 2006-12-02T02:07:43Z）和系统配置时区中相同格式的本地日期（例如 2006-12-02）。
也可以通过 UV_EXCLUDE_NEWER 环境变量设置。
包含指定额外名称的可选依赖项；可以多次提供。
仅适用于 pyproject.toml、setup.py 和 setup.cfg 源文件。
（已弃用：请改用 --index）除 --index-url 之外，要使用的软件包索引的额外 URL。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
通过此标志提供的所有索引的优先级高于 --index-url 指定的索引（默认值为 PyPI）。当提供多个 --extra-index-url 标志时，较早的值具有更高的优先级。
也可以通过 UV_EXTRA_INDEX_URL 环境变量设置。
--find-links, -f find-links除了在注册表索引中找到的候选发行版之外，还可以在这些位置搜索候选发行版。
如果是路径，目标必须是一个目录，该目录在顶层包含软件包的 wheel 文件（.whl）或源发行版（例如 .tar.gz 或 .zip）。
如果是 URL，该页面必须包含指向上述格式的软件包文件的平面链接列表。
也可以通过 UV_FIND_LINKS 环境变量设置。
--fork-strategy fork-strategy在跨 Python 版本和平台选择给定软件包的多个版本时使用的策略。
默认情况下，uv 将针对每个受支持的 Python 版本（requires-python）优化选择每个软件包的最新版本，同时尽量减少跨平台选择的版本数量。
在 fewest 模式下，uv 将尽量减少每个软件包选择的版本数量，优先选择与更广泛的受支持 Python 版本或平台兼容的较旧版本。
也可以通过 UV_FORK_STRATEGY 环境变量设置。
可能的值：
fewest：优化为每个软件包选择最少数量的版本。如果较旧版本与更广泛的受支持 Python 版本或平台兼容，则可能会优先选择它们requires-python：针对每个受支持的 Python 版本，优化选择每个软件包的最新支持版本
--format format解析结果应输出的格式。
支持 requirements.txt 和 pylock.toml（PEP 751）输出格式。
如果提供了输出文件，uv 将从输出文件的文件扩展名推断输出格式。否则，默认为 requirements.txt。
可能的值：
requirements.txt：以 requirements.txt 格式导出pylock.toml：以 pylock.toml 格式导出
--generate-hashes在输出文件中包含发行版哈希值
--group group从 pyproject.toml 安装指定的依赖项组。
如果未提供路径，则使用工作目录中的 pyproject.toml。
可以多次提供。
--help, -h显示此命令的简要帮助
--index index除默认索引外，解析依赖项时要使用的 URL。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
通过此标志提供的所有索引的优先级高于 --default-index 指定的索引（默认值为 PyPI）。当提供多个 --index 标志时，较早的值具有更高的优先级。
也可以通过 UV_INDEX 环境变量设置。
--index-strategy index-strategy针对多个索引 URL 进行解析时使用的策略。
默认情况下，uv 将在第一个找到给定软件包的索引处停止，并将解析限制在该第一个索引上存在的软件包（first-index
### uv pip sync
根据 `requirements.txt` 或 `pylock.toml` 文件同步环境。
同步环境时，`requirements.txt` 或 `pylock.toml` 文件中未列出的任何包都将被移除。若要保留无关包，请改用 `uv pip install`。
假定输入文件是 `pip compile` 或 `uv export` 操作的输出，其中将包含所有传递依赖项。如果文件中不存在传递依赖项，则不会安装它们。使用 `--strict` 可在缺少任何传递依赖项时发出警告。
用法
uv pip sync [OPTIONS] <SRC_FILE>...
参数
SRC_FILE包含给定 requirements.txt 文件中列出的所有包。
如果提供了 pyproject.toml、setup.py 或 setup.cfg 文件，uv 将提取相关项目的需求。
如果提供了 -，则将从标准输入读取需求。
选项
--allow-empty-requirements允许同步空需求，这将清除环境中的所有包
--allow-insecure-host, --trusted-host allow-insecure-host允许与主机建立不安全连接。
可以多次提供。
预期接收主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机将不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它绕过了 SSL 验证，可能使您面临中间人攻击。
也可以通过 UV_INSECURE_HOST 环境变量设置。
--break-system-packages允许 uv 修改 EXTERNALLY-MANAGED 的 Python 安装。
警告：--break-system-packages 旨在用于持续集成 (CI) 环境中，当安装到由外部包管理器（如 apt）管理的 Python 安装中时使用。应谨慎使用，因为此类 Python 安装明确建议不要由其他包管理器（如 uv 或 pip）进行修改。
也可以通过 UV_BREAK_SYSTEM_PACKAGES 环境变量设置。
--build-constraints, --build-constraint, -b build-constraints在构建源发行版时，使用给定的需求文件限制构建依赖项。
约束文件类似于 requirements.txt 文件，仅控制所安装需求的 版本。但是，在约束文件中包含一个包 不会 触发该包的安装。
也可以通过 UV_BUILD_CONSTRAINT 环境变量设置。
--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：禁用彩色输出
--compile-bytecode, --compile安装后将 Python 文件编译为字节码。
默认情况下，uv 不会将 Python（.py）文件编译为字节码（__pycache__/*.pyc）；相反，编译是在首次导入模块时延迟执行的。对于启动时间至关重要的用例，例如 CLI 应用程序和 Docker 容器，可以启用此选项，以较长的安装时间换取更快的启动时间。
启用后，uv 将处理整个 site-packages 目录（包括当前操作未修改的包）以保持一致性。与 pip 一样，它也将忽略错误。
也可以通过 UV_COMPILE_BYTECODE 环境变量设置。
--config-file config-file用于配置的 uv.toml 文件的路径。
虽然 uv 配置可以包含在 pyproject.toml 文件中，但在此上下文中不允许。
也可以通过 UV_CONFIG_FILE 环境变量设置。
--config-setting, --config-settings, -C config-setting传递给 PEP 517 构建后端的设置，指定为 KEY=VALUE 对
--constraints, --constraint, -c constraints使用给定的需求文件限制版本。
约束文件类似于 requirements.txt 文件，仅控制所安装需求的 版本。但是，在约束文件中包含一个包 不会 触发该包的安装。
这等效于 pip 的 --constraint 选项。
也可以通过 UV_CONSTRAINT 环境变量设置。
--default-index default-index默认包索引的 URL（默认值：）。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式的本地目录。
此标志指定的索引优先级低于通过 --index 标志指定的所有其他索引。
也可以通过 UV_DEFAULT_INDEX 环境变量设置。
--directory directory在运行命令之前切换到给定目录。
相对路径将以给定目录为基础进行解析。
请参阅 --project 仅更改项目根目录。
--dry-run执行试运行，即实际上不安装任何内容，但解析依赖项并打印生成的计划
--exclude-newer exclude-newer将候选包限制为在给定日期之前上传的包。
接受 RFC 3339 时间戳（例如 2006-12-02T02:07:43Z）和系统配置时区中相同格式的本地日期（例如 2006-12-02）。
也可以通过 UV_EXCLUDE_NEWER 环境变量设置。
（已弃用：请改用 --index）除 --index-url 之外，要使用的其他包索引 URL。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式的本地目录。
通过此标志提供的所有索引优先于 --index-url 指定的索引（默认指向 PyPI）。当提供多个 --extra-index-url 标志时，较早的值优先。
也可以通过 UV_EXTRA_INDEX_URL 环境变量设置。
--find-links, -f find-links除了在注册表索引中找到的候选分发之外，还可以在这些位置搜索候选分发。
如果是路径，目标必须是一个目录，该目录在顶层包含包的 wheel 文件（.whl）或源分发（例如 .tar.gz 或 .zip）。
如果是 URL，该页面必须包含指向上述格式的包文件的平面链接列表。
也可以通过 UV_FIND_LINKS 环境变量设置。
--help, -h显示此命令的简要帮助
--index index除默认索引外，解析依赖项时要使用的 URL。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式的本地目录。
通过此标志提供的所有索引优先于 --default-index 指定的索引（默认指向 PyPI）。当提供多个 --index 标志时，较早的值优先。
也可以通过 UV_INDEX 环境变量设置。
--index-strategy index-strategy针对多个索引 URL 进行解析时要使用的策略。
默认情况下，uv 将在第一个找到给定包的索引处停止，并将解析限制为该第一个索引上存在的内容（first-index）。这可以防止 “依赖混淆” 攻击，即攻击者可以将恶意包以上述相同名称上传到备用索引。
也可以通过 UV_INDEX_STRATEGY 环境变量设置。
可能的值：
first-index：仅使用第一个返回给定包名称匹配项的索引中的结果unsafe-first-match：在所有索引中搜索每个包名称，在继续下一个索引之前耗尽第一个索引中的版本unsafe-best-match：在所有索引中搜索每个包名称，优先选择找到的 “最佳” 版本。如果一个包版本存在于多个索引中，仅查看第一个索引中的条目
--index-url, -i index-url（已弃用：请改用 --default-index）Python 包索引的 URL（默认值：）。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式的本地目录。
此标志指定的索引优先级低于通过 --extra-index-url 标志指定的所有其他索引。
也可以通过 UV_INDEX_URL 环境变量设置。
--keyring-provider keyring-provider尝试使用 keyring 对索引 URL 进行身份验证。
目前，仅支持 --keyring-provider subprocess，这将配置 uv 使用 keyring CLI 来处理身份验证。
默认值为 disabled。
也可以通过 UV_KEYRING_PROVIDER 环境变量设置。
可能的值：
disabled：不使用 keyring 查找凭据subprocess：使用 keyring 命令查找凭据
--link-mode link-mode从全局缓存安装包时要使用的方法。
默认情况下，在 macOS 上为 clone（也称为写时复制），在 Linux 和 Windows 上为 hardlink。
也可以通过 UV_LINK_MODE 环境变量设置。
可能的值：
clone：将包从 wheel 克隆（即写时复制）到 site-packages 目录copy：将包从 wheel 复制到 site-packages 目录hardlink：将包从 wheel 硬链接到 site-packages 目录symlink：将包从 wheel 符号链接到 site-packages 目录
- 用法
uv pip install [OPTIONS] <PACKAGE|--requirements <REQUIREMENTS>|--editable <EDITABLE>|--group <GROUP>>
参数
PACKAGE安装列出的所有软件包。
软件包的顺序用于在解析时确定优先级。
选项
包含所有可选依赖项。
仅适用于 pyproject.toml、setup.py 和 setup.cfg 源。
--allow-insecure-host, --trusted-host allow-insecure-host允许与主机建立不安全连接。
可以多次提供。
预期接收主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它绕过了 SSL 验证，可能会使您遭受中间人攻击。
也可以通过 UV_INSECURE_HOST 环境变量设置。
--break-system-packages允许 uv 修改 EXTERNALLY-MANAGED 的 Python 安装。
警告：--break-system-packages 旨在用于持续集成 (CI) 环境中，当安装到由外部包管理器（如 apt）管理的 Python 安装中时使用。应谨慎使用，因为此类 Python 安装明确建议不要由其他包管理器（如 uv 或 pip）进行修改。
也可以通过 UV_BREAK_SYSTEM_PACKAGES 环境变量设置。
--build-constraints, --build-constraint, -b build-constraints在构建源发行版时，使用给定的需求文件限制构建依赖项。
约束文件类似于 requirements.txt 文件，仅控制所安装需求的 版本。但是，在约束文件中包含一个软件包 不会 触发该软件包的安装。
也可以通过 UV_BUILD_CONSTRAINT 环境变量设置。
--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：禁用彩色输出
--compile-bytecode, --compile安装后将 Python 文件编译为字节码。
默认情况下，uv 不会将 Python（.py）文件编译为字节码（__pycache__/*.pyc）；相反，编译是在首次导入模块时延迟执行的。对于启动时间至关重要的用例，例如 CLI 应用程序和 Docker 容器，可以启用此选项，以较长的安装时间换取更快的启动时间。
启用后，uv 将处理整个 site-packages 目录（包括当前操作未修改的软件包）以保持一致性。与 pip 一样，它也将忽略错误。
也可以通过 UV_COMPILE_BYTECODE 环境变量设置。
--config-file config-file用于配置的 uv.toml 文件的路径。
虽然 uv 配置可以包含在 pyproject.toml 文件中，但在此上下文中不允许。
也可以通过 UV_CONFIG_FILE 环境变量设置。
--config-setting, --config-settings, -C config-setting传递给 PEP 517 构建后端的设置，指定为 KEY=VALUE 对
--constraints, --constraint, -c constraints使用给定的需求文件限制版本。
约束文件类似于 requirements.txt 文件，仅控制所安装需求的 版本。但是，在约束文件中包含一个软件包 不会 触发该软件包的安装。
这等同于 pip 的 --constraint 选项。
也可以通过 UV_CONSTRAINT 环境变量设置。
--default-index default-index默认软件包索引的 URL（默认值：）。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
此标志指定的索引的优先级低于通过 --index 标志指定的所有其他索引。
也可以通过 UV_DEFAULT_INDEX 环境变量设置。
--directory directory在运行命令之前切换到给定目录。
相对路径以给定目录为基础进行解析。
请参阅 --project 仅更改项目根目录。
--dry-run执行试运行，即实际上不安装任何内容，但解析依赖项并打印生成的计划
--editable, -e editable根据提供的本地文件路径安装可编辑软件包
--exact执行精确同步，删除无关的软件包。
默认情况下，安装将进行最小必要的更改以满足需求。启用后，uv 将更新环境以完全匹配需求，删除需求中未包含的软件包。
--exclude-newer exclude-newer将候选软件包限制为在给定日期之前上传的软件包。
接受 RFC 3339 时间戳（例如 2006-12-02T02:07:43Z）和系统配置时区中相同格式的本地日期（例如 2006-12-02）。
也可以通过 UV_EXCLUDE_NEWER 环境变量设置。
包含指定额外名称的可选依赖项；可以多次提供。
仅适用于 pyproject.toml、setup.py 和 setup.cfg 源。
（已弃用：请改用 --index）除 --index-url 之外，要使用的软件包索引的额外 URL。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
通过此标志提供的所有索引优先于 --index-url 指定的索引（默认为 PyPI）。当提供多个 --extra-index-url 标志时，较早的值优先。
也可以通过 UV_EXTRA_INDEX_URL 环境变量设置。
--find-links, -f find-links除了在注册表索引中找到的候选分发之外，还可以在这些位置搜索候选分发。
如果是路径，目标必须是一个目录，该目录在顶层包含软件包的 wheel 文件（.whl）或源分发（例如 .tar.gz 或 .zip）。
如果是 URL，该页面必须包含符合上述格式的软件包文件的平面链接列表。
也可以通过 UV_FIND_LINKS 环境变量设置。
--fork-strategy fork-strategy在跨 Python 版本和平台选择给定软件包的多个版本时使用的策略。
默认情况下，uv 将针对每个受支持的 Python 版本（requires-python）优化选择每个软件包的最新版本，同时尽量减少跨平台选择的版本数量。
在 fewest 模式下，uv 将尽量减少每个软件包选择的版本数量，优先选择与更广泛的受支持 Python 版本或平台兼容的较旧版本。
也可以通过 UV_FORK_STRATEGY 环境变量设置。
可能的值：
fewest：优化为每个软件包选择最少数量的版本。如果较旧版本与更广泛的受支持 Python 版本或平台兼容，则可能优先选择它们requires-python：针对每个受支持的 Python 版本，优化选择每个软件包的最新支持版本
--group group从 pyproject.toml 中安装指定的依赖组。
如果未提供路径，则使用工作目录中的 pyproject.toml。
可以多次提供。
--help, -h显示此命令的简要帮助
--index index除默认索引外，解析依赖项时要使用的 URL。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
通过此标志提供的所有索引优先于 --default-index 指定的索引（默认为 PyPI）。当提供多个 --index 标志时，较早的值优先。
也可以通过 UV_INDEX 环境变量设置。
--index-strategy index-strategy针对多个索引 URL 进行解析时使用的策略。
默认情况下，uv 将在第一个找到给定软件包的索引处停止，并将解析限制在该第一个索引上存在的内容（first-index）。这可以防止 “依赖混淆” 攻击，即攻击者可以将恶意软件包以相同的名称上传到备用索引。
也可以通过 UV_INDEX_STRATEGY 环境变量设置。
可能的值：
first-index：仅使用第一个返回给定软件包名称匹配结果的索引中的结果unsafe-first-match：在所有索引中搜索每个软件包名称，在继续下一个索引之前用尽第一个索引中的版本unsafe-best-match：在所有索引中搜索每个软件包名称，优先选择找到的 “最佳” 版本。如果一个软件包版本在多个索引中，则仅查看第一个索引中的条目
--index-url, -i index-url（已弃用：请改用 --default-index）Python 软件包索引的 URL（默认值：）。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
此标志指定的索引的优先级低于通过 --extra-index-url 标志指定的所有其他索引。
也可以通过 UV_INDEX_URL 环境变量设置。
用法
uv pip uninstall [OPTIONS] <PACKAGE|--requirements <REQUIREMENTS>>
参数
PACKAGE卸载列出的所有软件包
选项
--allow-insecure-host, --trusted-host allow-insecure-host允许对主机进行不安全连接。
可多次提供。
需提供主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它会绕过 SSL 验证，可能使您面临中间人攻击。
也可通过 UV_INSECURE_HOST 环境变量设置。
--break-system-packages允许 uv 修改 EXTERNALLY-MANAGED 的 Python 安装。
警告：--break-system-packages 旨在用于持续集成 (CI) 环境中，当安装到由外部包管理器（如 apt）管理的 Python 安装中时使用。应谨慎使用，因为此类 Python 安装明确不建议由其他包管理器（如 uv 或 pip）进行修改。
也可通过 UV_BREAK_SYSTEM_PACKAGES 环境变量设置。
--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。
--dry-run执行试运行，即实际上不卸载任何内容，而是打印生成的计划
--help, -h显示此命令的简要帮助
--keyring-provider keyring-provider尝试使用 keyring 对远程需求文件进行身份验证。
目前，仅支持 --keyring-provider subprocess，这会将 uv 配置为使用 keyring CLI 来处理身份验证。
默认值为 disabled。
也可通过 UV_KEYRING_PROVIDER 环境变量设置。
可能的值：
disabled：不使用 keyring 查找凭据subprocess：使用 keyring 命令查找凭据
--managed-python要求使用 uv 管理的 Python 版本。
默认情况下，uv 倾向于使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。
也可通过 UV_MANAGED_PYTHON 环境变量设置。
--native-tls是否从平台的本机证书存储加载 TLS 证书。
默认情况下，uv 从捆绑的 webpki-roots 箱加载证书。webpki-roots 是来自 Mozilla 的一组可靠的信任根，将它们包含在 uv 中可提高可移植性和性能（尤其是在 macOS 上）。
但是，在某些情况下，您可能希望使用平台的本机证书存储，特别是如果您依赖于包含在系统证书存储中的公司信任根（例如，用于强制代理）。
也可通过 UV_NATIVE_TLS 环境变量设置。
--no-break-system-packages--no-cache, --no-cache-dir, -n避免读取或写入缓存，而是在操作期间使用临时目录
也可通过 UV_NO_CACHE 环境变量设置。
--no-config避免查找配置文件（pyproject.toml、uv.toml）。
通常，配置文件会在当前目录、父目录或用户配置目录中查找。
也可通过 UV_NO_CONFIG 环境变量设置。
--no-managed-python禁用使用 uv 管理的 Python 版本。
相反，uv 将在系统上搜索合适的 Python 版本。
也可通过 UV_NO_MANAGED_PYTHON 环境变量设置。
--no-progress隐藏所有进度输出。
例如，旋转器或进度条。
也可通过 UV_NO_PROGRESS 环境变量设置。
--no-python-downloads禁用 Python 的自动下载。
--offline禁用网络访问。
禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。
也可通过 UV_OFFLINE 环境变量设置。
--prefix prefix从指定的 --prefix 目录卸载软件包
--project project在给定的项目目录中运行命令。
所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来查找，项目的虚拟环境（.venv）也是如此。
其他命令行参数（如相对路径）将相对于当前工作目录进行解析。
有关完全更改工作目录的信息，请参阅 --directory。
在 uv pip 接口中使用此设置无效。
也可通过 UV_PROJECT 环境变量设置。
--python, -p python应从中卸载软件包的 Python 解释器。
默认情况下，卸载需要虚拟环境。可以提供替代 Python 的路径，但仅建议在持续集成 (CI) 环境中使用，并且应谨慎使用，因为它可能会修改系统 Python 安装。
有关 Python 查找和支持的请求格式的详细信息，请参阅 uv python。
也可通过 UV_PYTHON 环境变量设置。
--quiet, -q使用安静输出。
重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向标准输出写入任何内容。
--requirements, --requirement, -r requirements卸载给定需求文件中列出的所有软件包
--system使用系统 Python 卸载软件包。
默认情况下，uv 从当前工作目录或任何父目录中的虚拟环境中卸载。--system 选项指示 uv 改为使用系统 PATH 中找到的第一个 Python。
警告：--system 旨在用于持续集成 (CI) 环境中，应谨慎使用，因为它可能会修改系统 Python 安装。
也可通过 UV_SYSTEM_PYTHON 环境变量设置。
--target target从指定的 --target 目录卸载软件包
--verbose, -v使用详细输出。
您可以使用 RUST_LOG 环境变量配置细粒度日志记录。（
### uv pip freeze
以需求格式列出环境中安装的软件包
用法
选项
--allow-insecure-host, --trusted-host allow-insecure-host允许与主机建立不安全连接。
可多次提供。
预期接收主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它会绕过 SSL 验证，可能使您遭受中间人攻击。
也可以通过 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 仅更改项目根目录。
--exclude-editable从输出中排除任何可编辑的软件包
--help, -h显示此命令的简要帮助
--managed-python要求使用 uv 管理的 Python 版本。
默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。
也可以通过 UV_MANAGED_PYTHON 环境变量设置。
--native-tls是否从平台的本机证书存储加载 TLS 证书。
默认情况下，uv 从捆绑的 webpki-roots 箱中加载证书。webpki-roots 是来自 Mozilla 的一组可靠信任根，将它们包含在 uv 中可提高可移植性和性能（尤其是在 macOS 上）。
但是，在某些情况下，您可能希望使用平台的本机证书存储，特别是如果您依赖于包含在系统证书存储中的公司信任根（例如，用于强制代理）。
也可以通过 UV_NATIVE_TLS 环境变量设置。
--no-cache, --no-cache-dir, -n避免读取或写入缓存，而是在操作期间使用临时目录
也可以通过 UV_NO_CACHE 环境变量设置。
--no-config避免发现配置文件（pyproject.toml、uv.toml）。
通常，配置文件会在当前目录、父目录或用户配置目录中发现。
也可以通过 UV_NO_CONFIG 环境变量设置。
--no-managed-python禁用使用 uv 管理的 Python 版本。
相反，uv 将在系统上搜索合适的 Python 版本。
也可以通过 UV_NO_MANAGED_PYTHON 环境变量设置。
--no-progress隐藏所有进度输出。
例如，旋转器或进度条。
也可以通过 UV_NO_PROGRESS 环境变量设置。
--no-python-downloads禁用 Python 的自动下载。
--offline禁用网络访问。
禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。
也可以通过 UV_OFFLINE 环境变量设置。
--path paths限制为指定的安装路径以列出软件包（可多次使用）
--project project在给定的项目目录中运行命令。
所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来发现，项目的虚拟环境（.venv）也是如此。
其他命令行参数（例如相对路径）将相对于当前工作目录进行解析。
请参阅 --directory 以完全更改工作目录。
在 uv pip 接口中使用时，此设置无效。
也可以通过 UV_PROJECT 环境变量设置。
--python, -p python应列出其软件包的 Python 解释器。
默认情况下，uv 列出虚拟环境中的软件包，但如果未找到虚拟环境，则会显示系统 Python 环境中的软件包。
有关 Python 发现和支持的请求格式的详细信息，请参阅 uv python。
也可以通过 UV_PYTHON 环境变量设置。
--quiet, -q使用安静输出。
重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向标准输出写入任何输出。
--strict验证 Python 环境，以检测缺少依赖项和其他问题的软件包
--system列出系统 Python 环境中的软件包。
禁用虚拟环境的发现。
有关 Python 发现的详细信息，请参阅 uv python。
也可以通过 UV_SYSTEM_PYTHON 环境变量设置。
--verbose, -v使用详细输出。
您可以使用 RUST_LOG 环境变量配置细粒度日志记录。（<https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives>）
### uv pip list
以表格形式列出环境中安装的软件包
用法
选项
--allow-insecure-host, --trusted-host allow-insecure-host允许与主机建立不安全连接。
可多次提供。
接受主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它绕过了 SSL 验证，可能使您遭受中间人攻击。
也可以通过 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 环境变量设置。
--default-index default-index默认软件包索引的 URL（默认值：）。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
此标志指定的索引优先级低于通过 --index 标志指定的所有其他索引。
也可以通过 UV_DEFAULT_INDEX 环境变量设置。
--directory directory在运行命令之前切换到指定目录。
相对路径以指定目录为基础进行解析。
有关仅更改项目根目录的信息，请参阅 --project。
--editable, -e仅包含可编辑项目
--exclude exclude从输出中排除指定的软件包
--exclude-editable从输出中排除任何可编辑软件包
--exclude-newer exclude-newer将候选软件包限制为在给定日期之前上传的软件包。
接受 RFC 3339 时间戳（例如 2006-12-02T02:07:43Z）以及系统配置时区中相同格式的本地日期（例如 2006-12-02）。
也可以通过 UV_EXCLUDE_NEWER 环境变量设置。
（已弃用：请改用 --index）除 --index-url 之外，要使用的软件包索引的额外 URL。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
通过此标志提供的所有索引优先级高于 --index-url 指定的索引（默认为 PyPI）。当提供多个 --extra-index-url 标志时，较早的值优先级更高。
也可以通过 UV_EXTRA_INDEX_URL 环境变量设置。
--find-links, -f find-links除了在注册表索引中找到的候选分发之外，还可在这些位置搜索候选分发。
如果是路径，目标必须是一个目录，该目录在顶层包含 wheel 文件（.whl）或源分发（例如 .tar.gz 或 .zip）形式的软件包。
如果是 URL，该页面必须包含指向上述格式的软件包文件的平面链接列表。
也可以通过 UV_FIND_LINKS 环境变量设置。
--format format选择输出格式
[默认值：columns]
可能的值：
columns：以人类可读的表格形式显示软件包列表freeze：以类似 pip freeze 的格式显示软件包列表，每行一个软件包及其版本json：以机器可读的 JSON 格式显示软件包列表
--help, -h显示此命令的简要帮助
--index index除默认索引外，解析依赖项时要使用的 URL。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
通过此标志提供的所有索引优先级高于 --default-index 指定的索引（默认为 PyPI）。当提供多个 --index 标志时，较早的值优先级更高。
也可以通过 UV_INDEX 环境变量设置。
--index-strategy index-strategy针对多个索引 URL 进行解析时要使用的策略。
默认情况下，uv 将在找到给定软件包的第一个索引处停止，并将解析限制在该第一个索引上存在的内容（first-index）。这可防止 “依赖混淆” 攻击，攻击者可能会将恶意软件包以上述相同名称上传到备用索引。
也可以通过 UV_INDEX_STRATEGY 环境变量设置。
可能的值：
first-index：仅使用返回给定软件包名称匹配项的第一个索引的结果unsafe-first-match：在所有索引中搜索每个软件包名称，在继续下一个索引之前用尽第一个索引中的版本unsafe-best-match：在所有索引中搜索每个软件包名称，优先选择找到的 “最佳” 版本。如果一个软件包版本存在于多个索引中，仅查看第一个索引的条目
--index-url, -i index-url（已弃用：请改用 --default-index）Python 软件包索引的 URL（默认值：）。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
此标志指定的索引优先级低于通过 --extra-index-url 标志指定的所有其他索引。
也可以通过 UV_INDEX_URL 环境变量设置。
--keyring-provider keyring-provider尝试使用 keyring 对索引 URL 进行身份验证。
目前，仅支持 --keyring-provider subprocess，它将 uv 配置为使用 keyring CLI 来处理身份验证。
默认值为 disabled。
也可以通过 UV_KEYRING_PROVIDER 环境变量设置。
可能的值：
disabled：不使用 keyring 查找凭据subprocess：使用 keyring 命令查找凭据
--managed-python要求使用 uv 管理的 Python 版本。
默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。
也可以通过 UV_MANAGED_PYTHON 环境变量设置。
--native-tls是否从平台的本机证书存储加载 TLS 证书。
默认情况下，uv 从捆绑的 webpki-roots 库加载证书。webpki-roots 是来自 Mozilla 的一组可靠的信任根，将它们包含在 uv 中可提高可移植性和性能（尤其是在 macOS 上）。
但是，在某些情况下，您可能希望使用平台的本机证书存储，特别是如果您依赖于包含在系统证书存储中的公司信任根（例如，用于强制代理）。
也可以通过 UV_NATIVE_TLS 环境变量设置。
--no-cache, --no-cache-dir, -n避免读取或写入缓存，而是在操作期间使用临时目录
也可以通过 UV_NO_CACHE 环境变量设置。
--no-config避免查找配置文件（pyproject.toml、uv.toml）。
通常，配置文件会在当前目录、父目录或用户配置目录中查找。
也可以通过 UV_NO_CONFIG 环境变量设置。
--no-index忽略注册表索引（例如 PyPI），而是依赖直接 URL 依赖项以及通过 --find-links 提供的依赖项
--no-managed-python禁用 uv 管理的 Python 版本的使用。
相反，uv 将在系统上搜索合适的 Python 版本。
也可以通过 UV_NO_MANAGED_PYTHON 环境变量设置。
--no-progress隐藏所有进度输出。
例如，旋转器或进度条。
也可以通过 UV_NO_PROGRESS 环境变量设置。
--no-python-downloads禁用 Python 的自动下载。
--offline禁用网络访问。
禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。
也可以通过 UV_OFFLINE 环境变量设置。
--outdated列出过时的软件包。
每个软件包的最新版本将与已安装版本一起显示。最新的软件包将从输出中省略。
--project project在给定的项目目录中运行命令。
所有 pyproject.toml、uv.toml 和 .python-version 文件将从项目根目录向上遍历目录树进行查找，项目的虚拟环境（.venv）也是如此。
其他命令行参数（例如相对路径）将相对于当前工作目录进行解析。
有关完全更改工作目录的信息，请参阅 --directory。
在
### uv pip show
显示一个或多个已安装软件包的信息
用法
uv pip show [OPTIONS] [PACKAGE]...
参数
PACKAGE要显示的软件包
选项
--allow-insecure-host, --trusted-host allow-insecure-host允许与主机建立不安全连接。
可以多次提供。
预期接收主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它会绕过 SSL 验证，可能使您遭受中间人攻击。
也可以通过 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 仅更改项目根目录。
--files, -f显示每个软件包的完整已安装文件列表
--help, -h显示此命令的简要帮助
--managed-python要求使用 uv 管理的 Python 版本。
默认情况下，uv 优先使用它管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。
也可以通过 UV_MANAGED_PYTHON 环境变量设置。
--native-tls是否从平台的本机证书存储加载 TLS 证书。
默认情况下，uv 从捆绑的 webpki-roots 箱（crate）加载证书。webpki-roots 是来自 Mozilla 的一组可靠信任根，将它们包含在 uv 中可提高可移植性和性能（特别是在 macOS 上）。
但是，在某些情况下，您可能希望使用平台的本机证书存储，尤其是当您依赖包含在系统证书存储中的企业信任根（例如，用于强制代理）时。
也可以通过 UV_NATIVE_TLS 环境变量设置。
--no-cache, --no-cache-dir, -n避免读取或写入缓存，而是在操作期间使用临时目录
也可以通过 UV_NO_CACHE 环境变量设置。
--no-config避免发现配置文件（pyproject.toml、uv.toml）。
通常，配置文件会在当前目录、父目录或用户配置目录中发现。
也可以通过 UV_NO_CONFIG 环境变量设置。
--no-managed-python禁用使用 uv 管理的 Python 版本。
相反，uv 将在系统上搜索合适的 Python 版本。
也可以通过 UV_NO_MANAGED_PYTHON 环境变量设置。
--no-progress隐藏所有进度输出。
例如，旋转器或进度条。
也可以通过 UV_NO_PROGRESS 环境变量设置。
--no-python-downloads禁用 Python 的自动下载。
--offline禁用网络访问。
禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。
也可以通过 UV_OFFLINE 环境变量设置。
--project project在给定的项目目录中运行命令。
所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来发现，项目的虚拟环境（.venv）也是如此。
其他命令行参数（如相对路径）将相对于当前工作目录进行解析。
请参阅 --directory 以完全更改工作目录。
在 uv pip 接口中使用时，此设置无效。
也可以通过 UV_PROJECT 环境变量设置。
--python, -p python要在其中查找软件包的 Python 解释器。
默认情况下，uv 在虚拟环境中查找软件包，但如果未找到虚拟环境，则会在系统 Python 环境中查找软件包。
有关 Python 发现和支持的请求格式的详细信息，请参阅 uv python。
也可以通过 UV_PYTHON 环境变量设置。
--quiet, -q使用安静输出。
重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向标准输出写入任何内容。
--strict验证 Python 环境，以检测缺少依赖项和其他问题的软件包
--system显示系统 Python 环境中的软件包。
禁用虚拟环境的发现。
有关 Python 发现的详细信息，请参阅 uv python。
也可以通过 UV_SYSTEM_PYTHON 环境变量设置。
--verbose, -v使用详细输出。
您可以使用 RUST_LOG 环境变量配置细粒度日志记录。（
### uv pip tree
显示某个环境的依赖关系树
用法
选项
--allow-insecure-host, --trusted-host allow-insecure-host允许与某个主机建立不安全连接。
可多次提供该选项。
接受主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它绕过了 SSL 验证，可能会使您遭受中间人攻击。
也可以通过 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 环境变量设置。
--default-index default-index默认包索引的 URL（默认值：）。
接受符合 PEP 503（简单仓库 API）的仓库，或采用相同格式布局的本地目录。
此标志指定的索引优先级低于通过 --index 标志指定的所有其他索引。
也可以通过 UV_DEFAULT_INDEX 环境变量设置。
--depth, -d depth依赖关系树的最大显示深度
[默认值：255]
--directory directory在运行命令之前切换到指定目录。
相对路径将以指定目录为基础进行解析。
有关仅更改项目根目录的信息，请参阅 --project。
--exclude-newer exclude-newer将候选包限制为在指定日期之前上传的包。
接受 RFC 3339 时间戳（例如 2006-12-02T02:07:43Z）和系统配置时区中相同格式的本地日期（例如 2006-12-02）。
也可以通过 UV_EXCLUDE_NEWER 环境变量设置。
（已弃用：请改用 --index）除 --index-url 之外，要使用的额外包索引 URL。
接受符合 PEP 503（简单仓库 API）的仓库，或采用相同格式布局的本地目录。
通过此标志提供的所有索引优先级高于 --index-url 指定的索引（默认值为 PyPI）。当提供多个 --extra-index-url 标志时，较早的值优先级更高。
也可以通过 UV_EXTRA_INDEX_URL 环境变量设置。
--find-links, -f find-links除了在注册表索引中找到的候选分发之外，还可在这些位置搜索候选分发。
如果是路径，目标必须是一个目录，该目录在顶层包含 wheel 文件（.whl）或源分发（例如 .tar.gz 或 .zip）形式的包。
如果是 URL，该页面必须包含指向上述格式包文件的平面链接列表。
也可以通过 UV_FIND_LINKS 环境变量设置。
--help, -h显示此命令的简要帮助
--index index除默认索引外，解析依赖项时要使用的 URL。
接受符合 PEP 503（简单仓库 API）的仓库，或采用相同格式布局的本地目录。
通过此标志提供的所有索引优先级高于 --default-index 指定的索引（默认值为 PyPI）。当提供多个 --index 标志时，较早的值优先级更高。
也可以通过 UV_INDEX 环境变量设置。
--index-strategy index-strategy针对多个索引 URL 进行解析时要使用的策略。
默认情况下，uv 将在找到给定包的第一个索引处停止，并将解析限制在该第一个索引上存在的包（first-index）。这可防止 “依赖混淆” 攻击，攻击者可能会将恶意包以上述相同名称上传到备用索引。
也可以通过 UV_INDEX_STRATEGY 环境变量设置。
可能的值：
first-index：仅使用返回给定包名称匹配项的第一个索引的结果unsafe-first-match：在所有索引中搜索每个包名称，在继续下一个索引之前用尽第一个索引中的版本unsafe-best-match：在所有索引中搜索每个包名称，优先选择找到的 “最佳” 版本。如果一个包版本存在于多个索引中，仅查看第一个索引的条目
--index-url, -i index-url（已弃用：请改用 --default-index）Python 包索引的 URL（默认值：）。
接受符合 PEP 503（简单仓库 API）的仓库，或采用相同格式布局的本地目录。
此标志指定的索引优先级低于通过 --extra-index-url 标志指定的所有其他索引。
也可以通过 UV_INDEX_URL 环境变量设置。
--invert, --reverse显示给定包的反向依赖项。此标志将反转树并显示依赖于给定包的包
--keyring-provider keyring-provider尝试使用 keyring 对索引 URL 进行身份验证。
目前，仅支持 --keyring-provider subprocess，它将 uv 配置为使用 keyring CLI 来处理身份验证。
默认值为 disabled。
也可以通过 UV_KEYRING_PROVIDER 环境变量设置。
可能的值：
disabled：不使用 keyring 查找凭据subprocess：使用 keyring 命令查找凭据
--managed-python要求使用 uv 管理的 Python 版本。
默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。
也可以通过 UV_MANAGED_PYTHON 环境变量设置。
--native-tls是否从平台的本机证书存储加载 TLS 证书。
默认情况下，uv 从捆绑的 webpki-roots 库加载证书。webpki-roots 是来自 Mozilla 的一组可靠信任根，将它们包含在 uv 中可提高可移植性和性能（尤其是在 macOS 上）。
但是，在某些情况下，您可能希望使用平台的本机证书存储，特别是如果您依赖于包含在系统证书存储中的公司信任根（例如，用于强制代理）。
也可以通过 UV_NATIVE_TLS 环境变量设置。
--no-cache, --no-cache-dir, -n避免读取或写入缓存，而是在操作期间使用临时目录
也可以通过 UV_NO_CACHE 环境变量设置。
--no-config避免查找配置文件（pyproject.toml、uv.toml）。
通常，配置文件在当前目录、父目录或用户配置目录中查找。
也可以通过 UV_NO_CONFIG 环境变量设置。
--no-dedupe不重复删除重复的依赖项。通常，当一个包已经显示了它的依赖项时，进一步出现的相同包将不会重新显示其依赖项，并会包含一个 (*) 以表明它已经显示过。此标志将导致重复显示这些重复项
--no-index忽略注册表索引（例如 PyPI），而是依赖直接 URL 依赖项和通过 --find-links 提供的依赖项
--no-managed-python禁用 uv 管理的 Python 版本的使用。
相反，uv 将在系统上搜索合适的 Python 版本。
也可以通过 UV_NO_MANAGED_PYTHON 环境变量设置。
--no-progress隐藏所有进度输出。
例如，旋转器或进度条。
也可以通过 UV_NO_PROGRESS 环境变量设置。
--no-python-downloads禁用 Python 的自动下载。
--offline禁用网络访问。
禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。
也可以通过 UV_OFFLINE 环境变量设置。
--outdated显示树中每个包的最新可用版本
--package package仅显示指定的包
--project project在给定的项目目录中运行命令。
所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来查找，项目的虚拟环境（.venv）也是如此。
其他命令行参数（如相对路径）将相对于当前工作目录进行解析。
有关完全更改工作目录的信息，请参阅 --directory。
此设置在 uv pip 接口中使用时无效。
也可以通过 UV_PROJECT 环境变量设置。
### uv pip check
验证已安装的包是否具有兼容的依赖项
用法
选项
--allow-insecure-host, --trusted-host allow-insecure-host允许与主机建立不安全连接。
可多次提供。
预期接收主机名（例如 localhost）、主机端口对（例如 localhost:8080）或 URL（例如 https://localhost）。
警告：此列表中包含的主机不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它会绕过 SSL 验证，可能使您面临中间人攻击。
也可以通过 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 仅更改项目根目录。
--help, -h显示此命令的简要帮助
--managed-python要求使用 uv 管理的 Python 版本。
默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。
也可以通过 UV_MANAGED_PYTHON 环境变量设置。
--native-tls是否从平台的本机证书存储加载 TLS 证书。
默认情况下，uv 从捆绑的 webpki-roots 箱中加载证书。webpki-roots 是来自 Mozilla 的一组可靠的信任根，将它们包含在 uv 中可提高可移植性和性能（尤其是在 macOS 上）。
但是，在某些情况下，您可能希望使用平台的本机证书存储，特别是如果您依赖于包含在系统证书存储中的公司信任根（例如，用于强制代理）。
也可以通过 UV_NATIVE_TLS 环境变量设置。
--no-cache, --no-cache-dir, -n避免读取或写入缓存，而是在操作期间使用临时目录
也可以通过 UV_NO_CACHE 环境变量设置。
--no-config避免查找配置文件（pyproject.toml、uv.toml）。
通常，配置文件会在当前目录、父目录或用户配置目录中查找。
也可以通过 UV_NO_CONFIG 环境变量设置。
--no-managed-python禁用使用 uv 管理的 Python 版本。
相反，uv 将在系统上搜索合适的 Python 版本。
也可以通过 UV_NO_MANAGED_PYTHON 环境变量设置。
--no-progress隐藏所有进度输出。
例如，旋转器或进度条。
也可以通过 UV_NO_PROGRESS 环境变量设置。
--no-python-downloads禁用 Python 的自动下载。
--offline禁用网络访问。
禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。
也可以通过 UV_OFFLINE 环境变量设置。
--project project在给定的项目目录中运行命令。
所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来查找，项目的虚拟环境（.venv）也是如此。
其他命令行参数（如相对路径）将相对于当前工作目录进行解析。
请参阅 --directory 以完全更改工作目录。
在 uv pip 接口中使用此设置无效。
也可以通过 UV_PROJECT 环境变量设置。
--python, -p python应检查其包的 Python 解释器。
默认情况下，uv 检查虚拟环境中的包，但如果未找到虚拟环境，则会检查系统 Python 环境中的包。
有关 Python 查找和支持的请求格式的详细信息，请参阅 uv python。
也可以通过 UV_PYTHON 环境变量设置。
--quiet, -q使用安静输出。
重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向标准输出写入任何内容。
--system检查系统 Python 环境中的包。
禁用虚拟环境的查找。
有关 Python 查找的详细信息，请参阅 uv python。
也可以通过 UV_SYSTEM_PYTHON 环境变量设置。
--verbose, -v使用详细输出。
您可以使用 RUST_LOG 环境变量配置细粒度日志记录。（）
## uv venv
创建一个虚拟环境。
默认情况下，会在工作目录中创建一个名为 `.venv` 的虚拟环境。也可以通过位置参数指定其他路径。
如果处于项目中，可以使用 `UV_PROJECT_ENVIRONMENT` 环境变量更改默认的环境名称；此设置仅在从项目根目录运行时生效。
如果目标路径已存在虚拟环境，它将被删除，并创建一个新的空虚拟环境。
使用 uv 时，无需激活虚拟环境。uv 会在工作目录或任何父目录中查找名为 `.venv` 的虚拟环境。
### 用法
### 参数
PATH要创建的虚拟环境的路径。
默认是工作目录中的 .venv。
相对路径将相对于工作目录进行解析。
### 选项
--allow-existing保留目标路径上任何现有的文件或目录。
默认情况下，`uv venv` 会删除给定路径上现有的虚拟环境，如果该路径非空但不是虚拟环境，则会报错退出。`--allow-existing` 选项会直接写入给定路径，无论其内容如何，且不会事先清除。
警告：如果现有的虚拟环境和新创建的虚拟环境链接到不同的 Python 解释器，此选项可能会导致意外行为。
--allow-insecure-host, --trusted-host allow-insecure-host允许与主机建立不安全连接。
可以多次提供。
接受主机名（例如，localhost）、主机端口对（例如，localhost:8080）或 URL（例如，https://localhost）。
警告：此列表中包含的主机不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 `--allow-insecure-host`，因为它绕过了 SSL 验证，可能使您遭受中间人攻击。
也可以通过 `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` 环境变量设置。
--default-index default-index默认包索引的 URL（默认值：）。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
此标志指定的索引优先级低于通过 `--index` 标志指定的所有其他索引。
也可以通过 `UV_DEFAULT_INDEX` 环境变量设置。
--directory directory在运行命令之前切换到给定目录。
相对路径将以给定目录为基础进行解析。
有关仅更改项目根目录的信息，请参阅 `--project`。
--exclude-newer exclude-newer将候选包限制为在给定日期之前上传的包。
接受 RFC 3339 时间戳（例如，`2006-12-02T02:07:43Z`）和系统配置时区中相同格式的本地日期（例如，`2006-12-02`）。
也可以通过 `UV_EXCLUDE_NEWER` 环境变量设置。
（已弃用：请改用 `--index`）除 `--index-url` 之外，要使用的额外包索引 URL。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
通过此标志提供的所有索引优先级高于 `--index-url` 指定的索引（默认值为 PyPI）。当提供多个 `--extra-index-url` 标志时，较早的值优先级更高。
也可以通过 `UV_EXTRA_INDEX_URL` 环境变量设置。
--find-links, -f find-links除了在注册表索引中找到的包之外，还可以在这些位置搜索候选发行版。
如果是路径，目标必须是一个目录，该目录在顶层包含 wheel 文件（`.whl`）或源发行版（例如，`.tar.gz` 或 `.zip`）形式的包。
如果是 URL，该页面必须包含指向上述格式包文件的平面链接列表。
也可以通过 `UV_FIND_LINKS` 环境变量设置。
--help, -h显示此命令的简要帮助
--index index除默认索引外，解析依赖项时要使用的 URL。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
通过此标志提供的所有索引优先级高于 `--default-index` 指定的索引（默认值为 PyPI）。当提供多个 `--index` 标志时，较早的值优先级更高。
也可以通过 `UV_INDEX` 环境变量设置。
--index-strategy index-strategy针对多个索引 URL 进行解析时要使用的策略。
默认情况下，uv 会在第一个找到给定包的索引处停止，并将解析限制在该第一个索引上存在的包（`first-index`）。这可以防止 “依赖混淆” 攻击，即攻击者可以将恶意包以相同名称上传到备用索引。
也可以通过 `UV_INDEX_STRATEGY` 环境变量设置。
可能的值：
first-index：仅使用第一个返回给定包名称匹配结果的索引中的结果unsafe-first-match：在所有索引中搜索每个包名称，在移动到下一个索引之前用尽第一个索引中的版本unsafe-best-match：在所有索引中搜索每个包名称，优先选择找到的 “最佳” 版本。如果一个包版本存在于多个索引中，仅查看第一个索引中的条目
--index-url, -i index-url（已弃用：请改用 `--default-index`）Python 包索引的 URL（默认值：）。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式布局的本地目录。
此标志指定的索引优先级低于通过 `--extra-index-url` 标志指定的所有其他索引。
也可以通过 `UV_INDEX_URL` 环境变量设置。
--keyring-provider keyring-provider尝试使用 `keyring` 对索引 URL 进行身份验证。
目前，仅支持 `--keyring-provider subprocess`，它将 uv 配置为使用 `keyring` CLI 来处理身份验证。
默认值为 `disabled`。
也可以通过 `UV_KEYRING_PROVIDER` 环境变量设置。
可能的值：
disabled：不使用 keyring 查找凭据subprocess：使用 `keyring` 命令查找凭据
--link-mode link-mode从全局缓存安装包时要使用的方法。
此选项仅用于安装种子包。
在 macOS 上默认值为 `clone`（也称为写时复制），在 Linux 和 Windows 上为 `hardlink`。
也可以通过 `UV_LINK_MODE` 环境变量设置。
可能的值：
clone：将包从 wheel 克隆（即写时复制）到 `site-packages` 目录copy：将包从 wheel 复制到 `site-packages` 目录hardlink：将包从 wheel 硬链接到 `site-packages` 目录symlink：将包从 wheel 符号链接到 `site-packages` 目录
--managed-python要求使用 uv 管理的 Python 版本。
默认情况下，uv 优先使用它管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。
也可以通过 `UV_MANAGED_PYTHON` 环境变量设置。
--native-tls是否从平台的本机证书存储加载 TLS 证书。
默认情况下，uv 从捆绑的 `webpki-roots` 库加载证书。`webpki-roots` 是来自 Mozilla 的一组可靠信任根，将它们包含在 uv 中可提高可移植性和性能（特别是在 macOS 上）。
然而，在某些情况下，您可能希望使用平台的本机证书存储，尤其是当您依赖包含在系统证书存储中的企业信任根（例如，用于强制代理）时。
也可以通过 `UV_NATIVE_TLS` 环境变量设置。
--no-cache, --no-cache-dir, -n避免读取或写入缓存，而是在操作期间使用临时目录
也可以通过 `UV_NO_CACHE` 环境变量设置。
--no-config避免发现配置文件（`pyproject.toml`、`uv.toml`）。
通常，配置文件会在当前目录、父目录或用户配置目录中被发现。
也可以通过 `UV_NO_CONFIG` 环境变量设置。
--no-index忽略注册表索引（例如，PyPI），而是依赖直接 URL 依赖项和通过 `--find-links` 提供的依赖项
--no-managed-python禁用 uv 管理的 Python 版本的使用。
相反，uv 将在系统上搜索合适的 Python 版本。
也可以通过 `UV_NO_MANAGED_PYTHON` 环境变量设置。
--no-progress隐藏所有进度输出。
例如，旋转器或进度条。
也可以通过 `UV_NO_PROGRESS` 环境变量设置。
--no-project, --no-workspace避免发现项目或工作区。
默认情况下，uv 会在当前目录或任何父目录中搜索项目，以确定虚拟环境的默认路径，并检查是否有 Python 版本约束（如果有）。
--no-python-downloads禁用 Python 的自动下载。
--offline禁用网络访问。
禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。
也可以通过 `UV_OFFLINE` 环境变量设置。
--project project在给定的项目目录中运行命令。
所有 `pyproject.toml`、`uv.toml` 和 `.python-version` 文件
## uv build
将 Python 包构建为源发行版和 wheel 包。
`uv build` 接受一个目录路径或源发行版路径，默认值为当前工作目录。
默认情况下，如果传入一个目录，`uv build` 将从源目录构建源发行版（“sdist”），并从源发行版构建二进制发行版（“wheel”）。
可以使用 `uv build --sdist` 仅构建源发行版，使用 `uv build --wheel` 仅构建二进制发行版，使用 `uv build --sdist --wheel` 从源构建这两种发行版。
如果传入一个源发行版，`uv build --wheel` 将从源发行版构建一个 wheel 包。
### 使用方法
### 参数
SRC应从中构建发行版的目录，或要构建为 wheel 包的源发行版存档。
默认值为当前工作目录。
### 选项
--all-packages, --all构建工作区中的所有包。
将从提供的源目录中发现工作区，如果未提供源目录，则从当前目录中发现。
如果工作区成员不存在，uv 将以错误退出。
--allow-insecure-host, --trusted-host allow-insecure-host允许对主机进行不安全连接。
可以多次提供。
预期接收主机名（例如，localhost）、主机端口对（例如，localhost:8080）或 URL（例如，https://localhost）。
警告：此列表中包含的主机将不会根据系统的证书存储进行验证。仅在具有经过验证的源的安全网络中使用 --allow-insecure-host，因为它绕过了 SSL 验证，可能会使您遭受中间人攻击。
也可以通过 UV_INSECURE_HOST 环境变量设置。
--build-constraints, --build-constraint, -b build-constraints在构建发行版时，使用给定的需求文件限制构建依赖项。
约束文件类似于 requirements.txt 文件，仅控制安装的构建依赖项的 版本。但是，在约束文件中包含一个包本身 不会 触发该包的包含。
也可以通过 UV_BUILD_CONSTRAINT 环境变量设置。
--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 环境变量设置。
--config-setting, --config-settings, -C config-setting要传递给 PEP 517 构建后端的设置，指定为 KEY=VALUE 对
--default-index default-index默认包索引的 URL（默认值：）。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式的本地目录。
此标志指定的索引的优先级低于通过 --index 标志指定的所有其他索引。
也可以通过 UV_DEFAULT_INDEX 环境变量设置。
--directory directory在运行命令之前切换到给定目录。
相对路径以给定目录为基础进行解析。
请参阅 --project 仅更改项目根目录。
--exclude-newer exclude-newer将候选包限制为在给定日期之前上传的包。
接受 RFC 3339 时间戳（例如，2006-12-02T02:07:43Z）和您系统配置的时区中相同格式的本地日期（例如，2006-12-02）。
也可以通过 UV_EXCLUDE_NEWER 环境变量设置。
（已弃用：请改用 --index）除 --index-url 之外，要使用的包索引的额外 URL。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式的本地目录。
通过此标志提供的所有索引的优先级高于 --index-url 指定的索引（默认值为 PyPI）。当提供多个 --extra-index-url 标志时，较早的值具有更高的优先级。
也可以通过 UV_EXTRA_INDEX_URL 环境变量设置。
--find-links, -f find-links除了在注册表索引中找到的候选发行版之外，还可以在这些位置搜索候选发行版。
如果是路径，目标必须是一个目录，该目录在顶层包含 wheel 文件（.whl）或源发行版（例如，.tar.gz 或 .zip）形式的包。
如果是 URL，该页面必须包含指向上述格式的包文件的平面链接列表。
也可以通过 UV_FIND_LINKS 环境变量设置。
--force-pep517始终通过 PEP 517 进行构建，不要对 uv 构建后端使用快速路径。
默认情况下，uv 不会为使用 uv 构建后端的包创建 PEP 517 构建环境，而是使用直接调用构建后端的快速路径。此选项强制始终使用 PEP 517。
--fork-strategy fork-strategy在跨 Python 版本和平台选择给定包的多个版本时要使用的策略。
默认情况下，uv 将针对每个受支持的 Python 版本（requires-python）优化选择每个包的最新版本，同时尽量减少跨平台选择的版本数量。
在 fewest 策略下，uv 将尽量减少每个包选择的版本数量，优先选择与更广泛的受支持 Python 版本或平台兼容的较旧版本。
也可以通过 UV_FORK_STRATEGY 环境变量设置。
可能的值：
fewest：优化为每个包选择最少数量的版本。如果较旧版本与更广泛的受支持 Python 版本或平台兼容，则可能优先选择它们requires-python：针对每个受支持的 Python 版本，优化选择每个包的最新支持版本
--help, -h显示此命令的简要帮助
--index index在解析依赖项时除默认索引外要使用的 URL。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式的本地目录。
通过此标志提供的所有索引的优先级高于 --default-index 指定的索引（默认值为 PyPI）。当提供多个 --index 标志时，较早的值具有更高的优先级。
也可以通过 UV_INDEX 环境变量设置。
--index-strategy index-strategy在针对多个索引 URL 进行解析时要使用的策略。
默认情况下，uv 将在第一个找到给定包的索引处停止，并将解析限制为该第一个索引上存在的内容（first-index）。这可以防止 “依赖混淆” 攻击，即攻击者可以将恶意包以相同的名称上传到备用索引。
也可以通过 UV_INDEX_STRATEGY 环境变量设置。
可能的值：
first-index：仅使用第一个返回给定包名称匹配结果的索引中的结果unsafe-first-match：在所有索引中搜索每个包名称，在继续下一个索引之前耗尽第一个索引中的版本unsafe-best-match：在所有索引中搜索每个包名称，优先选择找到的 “最佳” 版本。如果一个包版本存在于多个索引中，仅查看第一个索引中的条目
--index-url, -i index-url（已弃用：请改用 --default-index）Python 包索引的 URL（默认值：）。
接受符合 PEP 503（简单存储库 API）的存储库，或采用相同格式的本地目录。
此标志指定的索引的优先级低于通过 --extra-index-url 标志指定的所有其他索引。
也可以通过 UV_INDEX_URL 环境变量设置。
--keyring-provider keyring-provider尝试使用 keyring 对索引 URL 进行身份验证。
目前，仅支持 --keyring-provider subprocess，它将 uv 配置为使用 keyring CLI 来处理身份验证。
默认值为 disabled。
也可以通过 UV_KEYRING_PROVIDER 环境变量设置。
可能的值：
disabled：不使用 keyring 查找凭据subprocess：使用 keyring 命令查找凭据
--link-mode link-mode从全局缓存安装包时要使用的方法。
此选项仅在构建源发行版时使用。
默认值在 macOS 上为 clone（也称为写时复制），在 Linux 和 Windows 上为 hardlink。
也可以通过 UV_LINK_MODE 环境变量设置。
可能的值：
clone：将包从 wheel 克隆（即写时复制）到 site-packages 目录copy：将包从 wheel 复制到 site-packages 目录hardlink：将包从 wheel 硬链接到 site-packages 目录symlink：将包从 wheel 符号链接到 site-packages 目录
--managed-python要求使用 uv 管理的 Python 版本。
默认情况下，uv 优先使用它管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用使用系统 Python 版本。
也可以通过 UV_MANAGED_PYTHON 环境变量设置。
--native-tls是否从平台的本机证书存储加载 TLS 证书。
默认情况下，uv 从捆绑的 webpki-roots 库加载证书。webpki-roots 是来自 Mozilla 的一组可靠的信任根，将它们包含在 uv 中可提高可移植性和性能（特别是在 macOS 上）。
但是，在某些情况下，您可能希望使用平台的本机证书存储，特别是如果您依赖于包含在系统证书存储中的公司信任根（例如，用于强制代理）。
也可以通过 UV_NATIVE_TLS 环境变量设置。
uv publish [OPTIONS] [FILES]...