Python versionsPythonのバージョン
A Python version is composed of a Python interpreter (i.e. the python executable), the standard
library, and other supporting files.Pythonのバージョンは、Pythonインタプリタ（すなわち、python実行可能ファイル）、標準ライブラリ、およびその他のサポートファイルで構成されています。
Managed and system Python installations管理されたPythonインストールとシステムPythonインストール
Since it is common for a system to have an existing Python installation, uv supports discovering Python versions. However, uv also supports installing Python versions itself. To distinguish between these two types of Python installations, uv refers to Python versions it installs as managed Python installations and all other Python installations as system Python installations.システムに既存のPythonインストールがあることが一般的であるため、uvはPythonのバージョンを発見することをサポートしています。しかし、uvはPythonのバージョンをインストールすることもサポートしています。これら2種類のPythonインストールを区別するために、uvはインストールしたPythonのバージョンを管理されたPythonインストールと呼び、その他のすべてのPythonインストールをシステムPythonインストールと呼びます。
Note注意
uv does not distinguish between Python versions installed by the operating system vs those
installed and managed by other tools. For example, if a Python installation is managed with
pyenv, it would still be considered a system Python version in uv.uvは、オペレーティングシステムによってインストールされたPythonのバージョンと、他のツールによってインストールおよび管理されたPythonのバージョンを区別しません。たとえば、Pythonのインストールがpyenvで管理されている場合、それはuvでは依然としてシステムPythonバージョンと見なされます。
Requesting a versionバージョンのリクエスト
A specific Python version can be requested with the --python flag in most uv commands. For
example, when creating a virtual environment:特定のPythonのバージョンは、ほとんどのuvコマンドで--pythonフラグを使用してリクエストできます。たとえば、仮想環境を作成する際には：
uv will ensure that Python 3.11.6 is available — downloading and installing it if necessary — then create the virtual environment with it.uvはPython 3.11.6が利用可能であることを確認し、必要に応じてダウンロードしてインストールし、その後それを使用して仮想環境を作成します。
The following Python version request formats are supported:以下のPythonバージョンリクエスト形式がサポートされています：
<version>(e.g.,3,3.12,3.12.3)<version>（例：3、3.12、3.12.3）<version-specifier>(e.g.,>=3.12,<3.13)<version-specifier>（例：>=3.12,<3.13）<version><short-variant>(e.g.,3.13t,3.12.0d)<version><short-variant>（例：3.13t、3.12.0d）<version>+<variant>(e.g.,3.13+freethreaded,3.12.0+debug,3.14+gil)<version>+<variant>（例：3.13+freethreaded、3.12.0+debug、3.14+gil）<implementation>(e.g.,cpythonorcp)<implementation>（例：cpythonまたはcp）<implementation>@<version>(e.g.,cpython@3.12)<implementation>@<version>（例：cpython@3.12）<implementation><version>(e.g.,cpython3.12orcp312)<implementation><version>（例：cpython3.12またはcp312）<implementation><version-specifier>(e.g.,cpython>=3.12,<3.13)<implementation><version-specifier>（例：cpython>=3.12,<3.13）<implementation>-<version>-<os>-<arch>-<libc>(e.g.,cpython-3.12.3-macos-aarch64-none)<implementation>-<version>-<os>-<arch>-<libc>（例：cpython-3.12.3-macos-aarch64-none）
Additionally, a specific system Python interpreter can be requested with:さらに、特定のシステムPythonインタプリタを次のようにリクエストできます：
<executable-path>(e.g.,/opt/homebrew/bin/python3)<executable-path>（例：/opt/homebrew/bin/python3）<executable-name>(e.g.,mypython3)<executable-name>（例：mypython3）<install-dir>(e.g.,/some/environment/)<install-dir>（例：/some/environment/）
By default, uv will automatically download Python versions if they cannot be found on the system.
This behavior can be
disabled with the python-downloads option.デフォルトでは、uvはシステム上で見つからない場合にPythonのバージョンを自動的にダウンロードします。
この動作は
python-downloadsオプションで無効にできます。
Python version filesPythonバージョンファイル
The .python-version file can be used to create a default Python version request. uv searches for a
.python-version file in the working directory and each of its parents. If none is found, uv will
check the user-level configuration directory. Any of the request formats described above can be
used, though use of a version number is recommended for interoperability with other tools..python-versionファイルはデフォルトのPythonバージョンリクエストを作成するために使用できます。uvは作業ディレクトリとその親ディレクトリ内で.python-versionファイルを検索します。見つからない場合、uvはユーザーレベルの設定ディレクトリを確認します。上記で説明したリクエスト形式のいずれかを使用できますが、他のツールとの相互運用性のためにバージョン番号の使用が推奨されます。
A .python-version file can be created in the current directory with the
uv python pin command.現在のディレクトリに.python-versionファイルを作成するには、
uv python pinコマンドを使用します。
A global .python-version file can be created in the user configuration directory with the
uv python pin --global command.ユーザー設定ディレクトリにグローバル.python-versionファイルを作成するには、
uv python pin --globalコマンドを使用します。
Discovery of .python-version files can be disabled with --no-config..python-versionファイルの発見は--no-configで無効にできます。
uv will not search for .python-version files beyond project or workspace boundaries (except the
user configuration directory).uvはプロジェクトまたはワークスペースの境界を超えて.python-versionファイルを検索しません（ユーザー設定ディレクトリを除く）。
Installing a Python versionPythonバージョンのインストール
uv bundles a list of downloadable CPython and PyPy distributions for macOS, Linux, and Windows.uvは、macOS、Linux、およびWindows用のダウンロード可能なCPythonおよびPyPyディストリビューションのリストを提供します。
Tipヒント
By default, Python versions are automatically downloaded as needed without using
uv python install.デフォルトでは、Pythonのバージョンは必要に応じて自動的にダウンロードされ、uv python installを使用しません。
To install a Python version at a specific version:特定のバージョンのPythonをインストールするには:
To install the latest patch version:最新のパッチバージョンをインストールするには:
To install a version that satisfies constraints:制約を満たすバージョンをインストールするには:
To install multiple versions:複数のバージョンをインストールするには:
To install a specific implementation:特定の実装をインストールするには:
All the Python version request formats are supported except those that are used for requesting local interpreters such as a file path.ローカルインタプリタを要求するために使用されるファイルパスなどを除いて、すべてのPythonバージョンリクエスト形式がサポートされています。
By default uv python install will verify that a managed Python version is installed or install the
latest version. If a .python-version file is present, uv will install the Python version listed in
the file. A project that requires multiple Python versions may define a .python-versions file. If
present, uv will install all the Python versions listed in the file.デフォルトでuv python installは、管理されたPythonバージョンがインストールされているか、最新のバージョンをインストールします。.python-versionファイルが存在する場合、uvはファイルに記載されたPythonバージョンをインストールします。複数のPythonバージョンを必要とするプロジェクトは、.python-versionsファイルを定義できます。存在する場合、uvはファイルに記載されたすべてのPythonバージョンをインストールします。
Important重要
The available Python versions are frozen for each uv release. To install new Python versions, you may need upgrade uv.利用可能なPythonバージョンは、各uvリリースごとに固定されています。新しいPythonバージョンをインストールするには、uvをアップグレードする必要があります。
See the storage documentation for details about where installed Python versions are stored.インストールされたPythonバージョンがどこに保存されているかの詳細については、ストレージドキュメントを参照してください。
Installing Python executablesPython実行可能ファイルのインストール
uv installs Python executables into your PATH by default, e.g., on Unix uv python install 3.12
will install a Python executable into ~/.local/bin, e.g., as python3.12. See the
storage documentation for more details about the
target directory.uvはデフォルトでPython実行可能ファイルをPATHにインストールします。例えば、Unixではuv python install 3.12が~/.local/binにPython実行可能ファイルをインストールし、例えばpython3.12として利用可能になります。ターゲットディレクトリに関する詳細は、ストレージドキュメントを参照してください。
Tipヒント
If ~/.local/bin is not in your PATH, you can add it with uv tool update-shell.~/.local/binがあなたのPATHに含まれていない場合は、uv tool update-shellを使って追加できます。
To install python and python3 executables, include the experimental --default option:pythonとpython3の実行可能ファイルをインストールするには、実験的な--defaultオプションを含めてください。
When installing Python executables, uv will only overwrite an existing executable if it is managed
by uv — e.g., if ~/.local/bin/python3.12 exists already uv will not overwrite it without the
--force flag.Python実行可能ファイルをインストールする際、uvは既存の実行可能ファイルを上書きするのはuvによって管理されている場合のみです。例えば、~/.local/bin/python3.12が既に存在する場合、--forceフラグなしでは上書きされません。
uv will update executables that it manages. However, it will prefer the latest patch version of each Python minor version by default. For example:uvは管理している実行可能ファイルを更新します。ただし、デフォルトでは各Pythonマイナーバージョンの最新のパッチバージョンを優先します。例えば：
$ uv python install 3.12.7 # Adds `python3.12` to `~/.local/bin`
$ uv python install 3.12.6 # Does not update `python3.12`
$ uv python install 3.12.8 # Updates `python3.12` to point to 3.12.8
Upgrading Python versionsPythonバージョンのアップグレード
Important重要
Support for upgrading Python versions is in preview. This means the behavior is experimental and subject to change.Pythonバージョンのアップグレードのサポートはプレビュー中です。これは、動作が実験的であり、変更される可能性があることを意味します。
Upgrades are only supported for uv-managed Python versions.アップグレードはuvによって管理されているPythonバージョンのみサポートされています。
Upgrades are not currently supported for PyPy and GraalPy.現在、PyPyおよびGraalPyのアップグレードはサポートされていません。
uv allows transparently upgrading Python versions to the latest patch release, e.g., 3.13.4 to 3.13.5. uv does not allow transparently upgrading across minor Python versions, e.g., 3.12 to 3.13, because changing minor versions can affect dependency resolution.uvは、Pythonのバージョンを最新のパッチリリースに透過的にアップグレードすることを可能にします。例えば、3.13.4から3.13.5へ。uvは、マイナーバージョン間の透過的なアップグレードを許可しません。例えば、3.12から3.13へ。なぜなら、マイナーバージョンの変更は依存関係の解決に影響を与える可能性があるからです。
uv-managed Python versions can be upgraded to the latest supported patch release with the
python upgrade command:uv管理のPythonバージョンは、python upgradeコマンドを使用して最新のサポートされているパッチリリースにアップグレードできます：
To upgrade a Python version to the latest supported patch release:Pythonのバージョンを最新のサポートされているパッチリリースにアップグレードするには：
To upgrade all installed Python versions:インストールされているすべてのPythonバージョンをアップグレードするには：
After an upgrade, uv will prefer the new version, but will retain the existing version as it may still be used by virtual environments.アップグレード後、uvは新しいバージョンを優先しますが、既存のバージョンは保持されます。なぜなら、それは仮想環境でまだ使用される可能性があるからです。
If the Python version was installed with the python-upgrade preview feature
enabled, e.g., uv python install 3.12 --preview-features python-upgrade, virtual environments
using the Python version will be automatically upgraded to the new patch version.Pythonのバージョンがpython-upgrade プレビュー機能を有効にしてインストールされた場合、例えば、uv python install 3.12 --preview-features python-upgrade、そのPythonバージョンを使用している仮想環境は自動的に新しいパッチバージョンにアップグレードされます。
Note注意
If the virtual environment was created before opting in to the preview mode, it will not be included in the automatic upgrades.プレビューモードにオプトインする前に作成された仮想環境は、自動アップグレードには含まれません。
If a virtual environment was created with an explicitly requested patch version, e.g.,
uv venv -p 3.10.8, it will not be transparently upgraded to a new version.明示的に要求されたパッチバージョンで作成された仮想環境、例えば、uv venv -p 3.10.8は、新しいバージョンに透過的にアップグレードされることはありません。
Minor version directoriesマイナーバージョンディレクトリ
Automatic upgrades for virtual environments are implemented using a directory with the Python minor version, e.g.:仮想環境の自動アップグレードは、Pythonのマイナーバージョンを持つディレクトリを使用して実装されています。例えば：
which is a symbolic link (on Unix) or junction (on Windows) pointing to a specific patch version:これは、特定のパッチバージョンを指すシンボリックリンク（Unixの場合）またはジャンクション（Windowsの場合）です：
$ readlink ~/.local/share/uv/python/cpython-3.12-macos-aarch64-none
~/.local/share/uv/python/cpython-3.12.11-macos-aarch64-none
If this link is resolved by another tool, e.g., by canonicalizing the Python interpreter path, and used to create a virtual environment, it will not be automatically upgraded.このリンクが他のツールによって解決される場合、例えばPythonインタプリタのパスを正規化することによって、仮想環境を作成するために使用されると、自動的にはアップグレードされません。
Project Python versionsプロジェクトのPythonバージョン
uv will respect Python requirements defined in requires-python in the pyproject.toml file during
project command invocations. The first Python version that is compatible with the requirement will
be used, unless a version is otherwise requested, e.g., via a .python-version file or the
--python flag.uvは、プロジェクトコマンドの呼び出し中にpyproject.tomlファイル内のrequires-pythonで定義されたPythonの要件を尊重します。要件に互換性のある最初のPythonバージョンが使用されますが、.python-versionファイルや--pythonフラグを介して別のバージョンが要求されている場合は、そのバージョンが使用されます。
Viewing available Python versions利用可能なPythonバージョンの表示
To list installed and available Python versions:インストールされているPythonバージョンと利用可能なPythonバージョンをリストするには：
To filter the Python versions, provide a request, e.g., to show all Python 3.13 interpreters:Pythonバージョンをフィルタリングするには、リクエストを提供します。例えば、すべてのPython 3.13インタプリタを表示するには：
Or, to show all PyPy interpreters:または、すべてのPyPyインタプリタを表示するには：
By default, downloads for other platforms and old patch versions are hidden.デフォルトでは、他のプラットフォームや古いパッチバージョンのダウンロードは非表示になっています。
To view all versions:すべてのバージョンを表示するには:
To view Python versions for other platforms:他のプラットフォームのPythonバージョンを表示するには:
To exclude downloads and only show installed Python versions:ダウンロードを除外し、インストールされたPythonバージョンのみを表示するには:
See the uv python list reference for more details.詳細については、uv python listリファレンスを参照してください。
Finding a Python executablePython実行可能ファイルの検索
To find a Python executable, use the uv python find command:Python実行可能ファイルを見つけるには、uv python findコマンドを使用します:
By default, this will display the path to the first available Python executable. See the discovery rules for details about how executables are discovered.デフォルトでは、これにより最初に利用可能なPython実行可能ファイルのパスが表示されます。実行可能ファイルがどのように発見されるかについての詳細は、 発見ルールを参照してください。
This interface also supports many request formats, e.g., to find a Python executable that has a version of 3.11 or newer:このインターフェースは、多くのリクエスト形式もサポートしています。例えば、バージョン3.11以上のPython実行可能ファイルを見つけるには:
By default, uv python find will include Python versions from virtual environments. If a .venv
directory is found in the working directory or any of the parent directories or the VIRTUAL_ENV
environment variable is set, it will take precedence over any Python executables on the PATH.デフォルトでは、uv python findは仮想環境からのPythonバージョンを含みます。作業ディレクトリまたは親ディレクトリのいずれかに.venvディレクトリが見つかるか、VIRTUAL_ENV環境変数が設定されている場合、それはPATH上の任意のPython実行可能ファイルよりも優先されます。
To ignore virtual environments, use the --system flag:仮想環境を無視するには、--systemフラグを使用します:
Discovery of Python versionsPythonバージョンの発見
When searching for a Python version, the following locations are checked:Pythonバージョンを検索する際、以下の場所がチェックされます：
- Managed Python installations in the
UV_PYTHON_INSTALL_DIR.UV_PYTHON_INSTALL_DIR内の管理されたPythonインストール。 - A Python interpreter on the
PATHaspython,python3, orpython3.xon macOS and Linux, orpython.exeon Windows.macOSおよびLinuxでは、PATH上のpython、python3、またはpython3.xとして、Windowsではpython.exe。 - On Windows, the Python interpreters in the Windows registry and Microsoft Store Python
interpreters (see
py --list-paths) that match the requested version.Windowsでは、要求されたバージョンに一致するWindowsレジストリ内のPythonインタープリタおよびMicrosoft StoreのPythonインタープリタ（py --list-pathsを参照）をチェックします。
In some cases, uv allows using a Python version from a virtual environment. In this case, the virtual environment's interpreter will be checked for compatibility with the request before searching for an installation as described above. See the pip-compatible virtual environment discovery documentation for details.場合によっては、uvは仮想環境からのPythonバージョンの使用を許可します。この場合、仮想環境のインタープリタがリクエストとの互換性を確認するためにチェックされ、その後、上記のようにインストールを検索します。詳細については、pip互換の仮想環境発見ドキュメントを参照してください。
When performing discovery, non-executable files will be ignored. Each discovered executable is queried for metadata to ensure it meets the requested Python version. If the query fails, the executable will be skipped. If the executable satisfies the request, it is used without inspecting additional executables.発見を行う際、実行可能でないファイルは無視されます。発見された各実行可能ファイルは、要求されたPythonバージョンを満たしているか確認するためにメタデータが照会されます。照会が失敗した場合、その実行可能ファイルはスキップされます。実行可能ファイルがリクエストを満たす場合、追加の実行可能ファイルを検査することなく使用されます。
When searching for a managed Python version, uv will prefer newer versions first. When searching for a system Python version, uv will use the first compatible version — not the newest version.管理されたPythonバージョンを検索する際、uvはまず新しいバージョンを優先します。システムPythonバージョンを検索する際、uvは最初の互換性のあるバージョンを使用します — 最新のバージョンではありません。
If a Python version cannot be found on the system, uv will check for a compatible managed Python version download.システム上でPythonバージョンが見つからない場合、uvは互換性のある管理されたPythonバージョンのダウンロードをチェックします。
Python pre-releasesPythonプレリリース
Python pre-releases will not be selected by default. Python pre-releases will be used if there is no other available installation matching the request. For example, if only a pre-release version is available it will be used but otherwise a stable release version will be used. Similarly, if the path to a pre-release Python executable is provided then no other Python version matches the request and the pre-release version will be used.Pythonのプレリリースはデフォルトでは選択されません。Pythonのプレリリースは、リクエストに一致する他のインストールがない場合に使用されます。例えば、プレリリースバージョンしか利用できない場合はそれが使用されますが、そうでなければ安定版リリースバージョンが使用されます。同様に、プレリリースのPython実行可能ファイルへのパスが提供された場合、他のPythonバージョンがリクエストに一致しないため、プレリリースバージョンが使用されます。
If a pre-release Python version is available and matches the request, uv will not download a stable Python version instead.プレリリースのPythonバージョンが利用可能でリクエストに一致する場合、uvは安定したPythonバージョンをダウンロードしません。
Free-threaded PythonフリースレッドPython
uv supports discovering and installing free-threaded Python variants in CPython 3.13+.uvは、CPython 3.13+でのフリースレッド Pythonバリアントの発見とインストールをサポートしています。
For Python 3.13, free-threaded Python versions will not be selected by default. Free-threaded Python
versions will only be selected when explicitly requested, e.g., with 3.13t or 3.13+freethreaded.Python 3.13では、フリースレッドPythonバージョンはデフォルトでは選択されません。フリースレッドPythonバージョンは、明示的にリクエストされた場合のみ選択されます。例えば、3.13tや3.13+freethreadedを使用します。
For Python 3.14+, uv will allow use of free-threaded Python 3.14+ interpreters without explicit
selection. The GIL-enabled build of Python will still be preferred, e.g., when performing an
installation with uv python install 3.14. However, e.g., if a free-threaded interpreter comes
before a GIL-enabled build on the PATH, it will be used.Python 3.14+では、uvは明示的な選択なしにフリースレッドPython 3.14+インタープリタの使用を許可します。GIL対応ビルドのPythonが優先されます。例えば、uv python install 3.14を使用してインストールを行う場合です。ただし、例えば、フリースレッドインタープリタがPATH上でGIL対応ビルドの前にある場合、それが使用されます。
If both free-threaded and GIL-enabled Python versions are available on the system, and want to
require the use of the GIL-enabled variant in a project, you can use the +gil variant specifier.システムにフリースレッドとGIL対応のPythonバージョンの両方が利用可能で、プロジェクトでGIL対応のバリアントを使用する必要がある場合は、+gilバリアント指定子を使用できます。
Debug Python variantsデバッグPythonバリアント
uv supports discovering and installing debug builds of Python, i.e., with debug assertions enabled.uvは、デバッグアサーションが有効なPythonのデバッグビルドの発見とインストールをサポートしています。
Important重要
Debug builds of Python are slower and are not appropriate for general use.Pythonのデバッグビルドは遅く、一般的な使用には適していません。
Debug builds will be used if there is no other available installation matching the request. For example, if only a debug version is available it will be used but otherwise a stable release version will be used. Similarly, if the path to a debug Python executable is provided then no other Python version matches the request and the debug version will be used.デバッグビルドは、リクエストに一致する他のインストールが利用できない場合に使用されます。例えば、デバッグ版のみが利用可能な場合はそれが使用されますが、そうでなければ安定版が使用されます。同様に、デバッグPython実行可能ファイルへのパスが提供されている場合、他のPythonバージョンがリクエストに一致しないため、デバッグ版が使用されます。
Debug builds of Python can be explicitly requested with, e.g., 3.13d or 3.13+debug.Pythonのデバッグビルドは、例えば、3.13dや3.13+debugを使用して明示的にリクエストできます。
Note注意
CPython versions installed by uv usually have debug symbols stripped to reduce the distribution size. These debug builds do not have debug symbols stripped, which can be useful when debugging Python processes with a C-level debugger.uvによってインストールされたCPythonバージョンは、配布サイズを減らすためにデバッグシンボルが削除されていることが多いです。これらのデバッグビルドはデバッグシンボルが削除されていないため、Cレベルのデバッガを使用してPythonプロセスをデバッグする際に便利です。
Disabling automatic Python downloads自動Pythonダウンロードの無効化
By default, uv will automatically download Python versions when needed.デフォルトでは、uvは必要に応じてPythonバージョンを自動的にダウンロードします。
The python-downloads option can be used to disable
this behavior. By default, it is set to automatic; set to manual to only allow Python downloads
during uv python install.python-downloadsオプションを使用して、この動作を無効にすることができます。デフォルトでは、automaticに設定されており、uv python install中のみPythonのダウンロードを許可するにはmanualに設定します。
Tipヒント
The python-downloads setting can be set in a
persistent configuration file to change the default behavior, or
the --no-python-downloads flag can be passed to any uv command.python-downloads設定は、デフォルトの動作を変更するために永続的な設定ファイルに設定することができ、または--no-python-downloadsフラグを任意のuvコマンドに渡すことができます。
Requiring or disabling managed Python versions管理されたPythonバージョンの要求または無効化
By default, uv will attempt to use Python versions found on the system and only download managed
Python versions when necessary. To ignore system Python versions, and only use managed Python
versions, use the --managed-python flag:デフォルトでは、uvはシステム上で見つかったPythonバージョンを使用し、必要に応じてのみ管理されたPythonバージョンをダウンロードしようとします。システムPythonバージョンを無視し、管理されたPythonバージョンのみを使用するには、--managed-pythonフラグを使用します。
Similarly, to ignore managed Python versions and only use system Python versions, use the
--no-managed-python flag:同様に、管理されたPythonバージョンを無視し、システムPythonバージョンのみを使用するには、--no-managed-pythonフラグを使用します。
To change uv's default behavior in a configuration file, use the
python-preference setting.uvのデフォルトの動作を設定ファイルで変更するには、
python-preference 設定を使用します。
Adjusting Python version preferencesPythonバージョンの設定を調整する
The python-preference setting determines whether to
prefer using Python installations that are already present on the system, or those that are
downloaded and installed by uv.python-preference 設定は、システムに既に存在するPythonインストールを優先するか、uvによってダウンロードおよびインストールされたPythonを優先するかを決定します。
By default, the python-preference is set to managed which prefers managed Python installations
over system Python installations. However, system Python installations are still preferred over
downloading a managed Python version.デフォルトでは、python-preference はmanagedに設定されており、システムのPythonインストールよりも管理されたPythonインストールを優先します。ただし、システムのPythonインストールは、管理されたPythonバージョンをダウンロードするよりも優先されます。
The following alternative options are available:以下の代替オプションが利用可能です：
only-managed: Only use managed Python installations; never use system Python installations. Equivalent to--managed-python.only-managed: 管理されたPythonインストールのみを使用し、システムのPythonインストールは決して使用しません。--managed-pythonと同等です。system: Prefer system Python installations over managed Python installations.system: 管理されたPythonインストールよりもシステムのPythonインストールを優先します。only-system: Only use system Python installations; never use managed Python installations. Equivalent to--no-managed-python.only-system: システムのPythonインストールのみを使用し、管理されたPythonインストールは決して使用しません。--no-managed-pythonと同等です。
Note注意
Automatic Python version downloads can be disabled without changing the preference.自動Pythonバージョンのダウンロードは、無効にすることができ、設定を変更することなく行えます。
Python implementation supportPython実装サポート
uv supports the CPython, PyPy, Pyodide, and GraalPy Python implementations. If a Python implementation is not supported, uv will fail to discover its interpreter.uvはCPython、PyPy、Pyodide、およびGraalPyのPython実装をサポートしています。サポートされていないPython実装の場合、uvはそのインタプリタを発見できません。
The implementations may be requested with either the long or short name:実装は、長い名前または短い名前のいずれかで要求できます：
- CPython:
cpython,cpCPython:cpython、cp - PyPy:
pypy,ppPyPy:pypy、pp - GraalPy:
graalpy,gpGraalPy:graalpy、gp - Pyodide:
pyodidePyodide:pyodide
Implementation name requests are not case-sensitive.実装名の要求は大文字と小文字を区別しません。
See the Python version request documentation for more details on the supported formats.Pythonバージョン要求のドキュメントを参照して、サポートされているフォーマットの詳細を確認してください。
Managed Python distributions管理されたPythonディストリビューション
uv supports downloading and installing CPython, PyPy, and Pyodide distributions.uvはCPython、PyPy、およびPyodideのディストリビューションのダウンロードとインストールをサポートしています。
CPython distributionsCPythonの配布物
As Python does not publish official distributable CPython binaries, uv instead uses pre-built
distributions from the Astral
python-build-standalone project.
python-build-standalone is also is used in many other Python projects, like
Mise and
bazelbuild/rules_python.Pythonは公式の配布可能なCPythonバイナリを公開していないため、uvは代わりにAstralのpython-build-standaloneプロジェクトからのプリビルドされた配布物を使用します。python-build-standaloneは、Miseやbazelbuild/rules_pythonのような他の多くのPythonプロジェクトでも使用されています。
The uv Python distributions are self-contained, highly-portable, and performant. While Python can be
built from source, as in tools like pyenv, doing so requires preinstalled system dependencies, and
creating optimized, performant builds (e.g., with PGO and LTO enabled) is very slow.uvのPython配布物は自己完結型で、高い移植性とパフォーマンスを持っています。Pythonはpyenvのようなツールを使ってソースからビルドすることもできますが、その場合は事前にシステム依存関係をインストールする必要があり、最適化されたパフォーマンスビルド（例：PGOおよびLTOを有効にしたもの）を作成するのは非常に遅くなります。
These distributions have some behavior quirks, generally as a consequence of portability; see the
python-build-standalone quirks
documentation for details.これらの配布物にはいくつかの動作の癖がありますが、一般的には移植性の結果としてのものです。詳細については、python-build-standaloneの癖に関するドキュメントを参照してください。
PyPy distributionsPyPyの配布物
PyPy distributions are provided by the PyPy project.PyPyの配布物はPyPyプロジェクトによって提供されています。
Pyodide distributionsPyodideの配布物
Pyodide distributions are provided by the Pyodide project.Pyodideの配布物はPyodideプロジェクトによって提供されています。
Pyodide is a port of CPython for the WebAssembly / Emscripten platform.PyodideはWebAssembly / Emscriptenプラットフォーム向けのCPythonのポートです。
Transparent x86_64 emulation on aarch64aarch64上の透明なx86_64エミュレーション
Both macOS and Windows support running x86_64 binaries on aarch64 through transparent emulation. This is called Rosetta 2 or Windows on ARM (WoA) emulation. It's possible to use x86_64 uv on aarch64, and also possible to use an x86_64 Python interpreter on aarch64. Either uv binary can use either Python interpreter, but a Python interpreter needs packages for its architecture, either all x86_64 or all aarch64.macOSとWindowsの両方は、透過的エミュレーションを通じてx86_64バイナリをaarch64上で実行することをサポートしています。 これはRosetta 2または Windows on ARM (WoA) エミュレーションと呼ばれています。 x86_64のuvをaarch64上で使用することも可能であり、x86_64のPythonインタプリタをaarch64上で使用することも可能です。 どちらのuvバイナリもどちらのPythonインタプリタを使用できますが、Pythonインタプリタはそのアーキテクチャ用のパッケージが必要です。 すべてx86_64またはすべてaarch64のいずれかです。
Registration in the Windows registryWindowsレジストリへの登録
On Windows, installation of managed Python versions will register them with the Windows registry as defined by PEP 514.Windowsでは、管理されたPythonバージョンのインストールは、PEP 514で定義されたように、Windowsレジストリに登録されます。
After installation, the Python versions can be selected with the py launcher, e.g.:インストール後、Pythonバージョンはpyランチャーを使用して選択できます。例えば：
On uninstall, uv will remove the registry entry for the target version as well as any broken registry entries.アンインストール時、uvはターゲットバージョンのレジストリエントリと、壊れたレジストリエントリを削除します。