预览功能
uv 包含可选的预览功能,旨在为社区提供反馈机会,并在向所有人开放之前,提高对这些变更确实能带来净收益的信心。
启用预览功能
要启用所有预览功能,请使用 --preview 标志
或者,设置 UV_PREVIEW 环境变量
要启用特定的预览功能,请使用 --preview-features 标志
--preview-features 标志可以重复使用以启用多个功能
或者,也可以通过逗号分隔的列表提供功能名称
UV_PREVIEW_FEATURES 环境变量也可以类似地使用,例如
为了向后兼容,启用不存在的预览功能会发出警告,但不会报错。
使用预览功能
通常,如果行为变更受到某种用户交互的限制,则无需更改任何预览设置即可使用预览功能。例如,虽然 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:允许安装python和python3可执行文件。format:允许使用uv format。native-auth:启用将凭据存储在系统原生位置。workspace-metadata:允许使用uv workspace metadata。workspace-dir:允许使用uv workspace dir。workspace-list:允许使用uv workspace list。
禁用预览功能
可以使用 --no-preview 选项来禁用预览功能。