跳到内容

预览功能

uv 包含可选的预览功能,旨在为社区提供反馈机会,并在向所有人开放之前,提高对这些变更确实能带来净收益的信心。

启用预览功能

要启用所有预览功能,请使用 --preview 标志

$ uv run --preview ...

或者,设置 UV_PREVIEW 环境变量

$ UV_PREVIEW=1 uv run ...

要启用特定的预览功能,请使用 --preview-features 标志

$ uv run --preview-features foo ...

--preview-features 标志可以重复使用以启用多个功能

$ uv run --preview-features foo --preview-features bar ...

或者,也可以通过逗号分隔的列表提供功能名称

$ uv run --preview-features foo,bar ...

UV_PREVIEW_FEATURES 环境变量也可以类似地使用,例如

$ UV_PREVIEW_FEATURES=foo,bar uv run ...

为了向后兼容,启用不存在的预览功能会发出警告,但不会报错。

使用预览功能

通常,如果行为变更受到某种用户交互的限制,则无需更改任何预览设置即可使用预览功能。例如,虽然 pylock.toml 支持处于预览阶段,但您可以在 uv pip install 中使用 pylock.toml 文件,而无需额外配置,因为指定 pylock.toml 文件即表明您希望使用该功能。不过,系统会显示一个警告,提示该功能处于预览状态。启用该预览功能可以消除此警告。

可用的预览功能

以下是可用的预览功能

  • add-bounds:允许配置 uv add 调用的默认边界
  • json-output:允许在各种 uv 命令中使用 --output-format json
  • package-conflicts:允许在包级别定义工作区冲突。
  • pylock:允许从 pylock.toml 文件安装。
  • python-install-default:允许安装 pythonpython3 可执行文件
  • format:允许使用 uv format
  • native-auth:启用将凭据存储在系统原生位置
  • workspace-metadata:允许使用 uv workspace metadata
  • workspace-dir:允许使用 uv workspace dir
  • workspace-list:允许使用 uv workspace list

禁用预览功能

可以使用 --no-preview 选项来禁用预览功能。