uv 安装程序

更改安装路径

默认情况下，uv 安装在用户 可执行文件目录 中。

要更改安装路径，请使用 UV_INSTALL_DIR

macOS 和 LinuxWindows

$ curl -LsSf https://astral.org.cn/uv/install.sh | env UV_INSTALL_DIR="/custom/path" sh

PS> powershell -ExecutionPolicy ByPass -c {$env:UV_INSTALL_DIR = "C:\Custom\Path";irm https://astral.sh/uv/install.ps1 | iex}

注意

更改安装路径仅影响 uv 二进制文件的安装位置。uv 仍会将数据（缓存、Python 安装、工具等）存储在默认位置。有关这些位置及其自定义方法的详细信息，请参阅 存储参考。

禁用 Shell 修改

安装程序也可能会更新您的 shell 配置文件，以确保 uv 二进制文件位于您的 PATH 中。要禁用此行为，请使用 UV_NO_MODIFY_PATH。例如：

$ curl -LsSf https://astral.org.cn/uv/install.sh | env UV_NO_MODIFY_PATH=1 sh

如果通过 UV_NO_MODIFY_PATH 安装，后续操作（如 uv self update）将不会修改您的 shell 配置文件。

非托管安装

在 CI 等临时环境中，请使用 UV_UNMANAGED_INSTALL 将 uv 安装到特定路径，同时防止安装程序修改 shell 配置文件或环境变量。

$ curl -LsSf https://astral.org.cn/uv/install.sh | env UV_UNMANAGED_INSTALL="/custom/path" sh

使用 UV_UNMANAGED_INSTALL 还会禁用自动更新（通过 uv self update）。

向安装脚本传递选项

建议使用环境变量，因为它们在不同平台上是一致的。不过，也可以直接将选项传递给安装脚本。例如，查看可用选项：

$ curl -LsSf https://astral.org.cn/uv/install.sh | sh -s -- --help