Preview featuresプレビュー機能
uv includes opt-in preview features to provide an opportunity for community feedback and increase confidence that changes are a net-benefit before enabling them for everyone.uv には、コミュニティからのフィードバックを得る機会を提供し、すべてのユーザーに対して有効化する前に変更が純粋な利益であることを確認するために、オプトインのプレビュー機能が含まれています。
Enabling preview featuresプレビュー機能の有効化
To enable all preview features, use the --preview flag:すべてのプレビュー機能を有効にするには、--previewフラグを使用します:
Or, set the UV_PREVIEW environment variable:または、UV_PREVIEW環境変数を設定します:
To enable specific preview features, use the --preview-features flag:特定のプレビュー機能を有効にするには、--preview-featuresフラグを使用します:
The --preview-features flag can be repeated to enable multiple features:--preview-featuresフラグは、複数の機能を有効にするために繰り返し使用できます:
Or, features can be provided in a comma separated list:または、機能をカンマ区切りのリストで提供することもできます:
The UV_PREVIEW_FEATURES environment variable can be used similarly, e.g.:UV_PREVIEW_FEATURES環境変数も同様に使用できます。例:
For backwards compatibility, enabling preview features that do not exist will warn, but not error.後方互換性のため、存在しないプレビュー機能を有効にすると警告が表示されますが、エラーにはなりません。
Using preview featuresプレビュー機能の使用
Often, preview features can be used without changing any preview settings if the behavior change is
gated by some sort of user interaction, For example, while pylock.toml support is in preview, you
can use uv pip install with a pylock.toml file without additional configuration because
specifying the pylock.toml file indicates you want to use the feature. However, a warning will be
displayed that the feature is in preview. The preview feature can be enabled to silence the warning.多くの場合、プレビュー機能は、動作の変更が何らかのユーザーインタラクションによって制御されている場合、プレビュー設定を変更せずに使用できます。例えば、pylock.tomlサポートがプレビュー中である間、追加の設定なしでpylock.tomlファイルを使用してuv pip installを実行できます。これは、pylock.tomlファイルを指定することで、その機能を使用したいことを示すためです。ただし、その機能がプレビュー中であることを警告するメッセージが表示されます。プレビュー機能を有効にすることで、警告を抑制できます。
Other preview features change behavior without changes to your use of uv. For example, when the
python-upgrade feature is enabled, the default behavior of uv python install changes to allow uv
to upgrade Python versions transparently. This feature requires enabling the preview flag for proper
usage.他のプレビュー機能は、uvの使用方法に変更を加えることなく動作を変更します。例えば、python-upgrade機能が有効になっている場合、uv python installのデフォルトの動作が変更され、uvがPythonのバージョンを透過的にアップグレードできるようになります。この機能を正しく使用するには、プレビューフラグを有効にする必要があります。
Available preview features利用可能なプレビュー機能
The following preview features are available:以下のプレビュー機能が利用可能です：
add-bounds: Allows configuring the default bounds foruv addinvocations.add-bounds:uv add呼び出しのデフォルトの境界を設定することを許可します。json-output: Allows--output-format jsonfor various uv commands.json-output: 様々なuvコマンドに対して--output-format jsonを許可します。package-conflicts: Allows defining workspace conflicts at the package level.package-conflicts: パッケージレベルでワークスペースの競合を定義することを許可します。pylock: Allows installing frompylock.tomlfiles.pylock:pylock.tomlファイルからインストールすることを許可します。python-install-default: Allows installingpythonandpython3executables.python-install-default: pythonおよびpython3実行可能ファイルをインストールすることを許可します。python-upgrade: Allows transparent Python version upgrades.python-upgrade: 透過的なPythonバージョンのアップグレードを許可します。format: Allows usinguv format.format:uv formatを使用することを許可します。native-auth: Enables storage of credentials in a system-native location.native-auth: 認証情報を システムネイティブの場所に保存することを有効にします。workspace-metadata: Allows usinguv workspace metadata.workspace-metadata:uv workspace metadataを使用することを許可します。workspace-dir: Allows usinguv workspace dir.workspace-dir:uv workspace dirを使用することを許可します。workspace-list: Allows usinguv workspace list.workspace-list:uv workspace listを使用することを許可します。
Disabling preview featuresプレビュー機能の無効化
The --no-preview option can be used to disable preview features.--no-previewオプションを使用してプレビュー機能を無効にすることができます。