uv教程：安装

作者：马育民 • • 阅读：10043

快速安装-windows系统

  • uv安装到默认路径 C:\Users\你的用户名\.uv\

  • 安装python的默认路径：C:\Users\你的名字\.uv\python

  • uv 下载的所有包缓存的默认路径：C:\Users\你的名字\.cache\uv

  • uv 安装的工具（ruff、black、jupyter）默认路径：C:\Users\你的名字\.uv\tools

方式一：独立安装（推荐，无需 Python 环境）

启动 PowerShell（执行PowerShell脚本），执行下面命令：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

  1. powershell
    意思：启动 Windows 的 PowerShell 命令行工具

  2. -ExecutionPolicy ByPass
    意思：临时允许运行远程脚本，不拦截安全提示
    Windows 默认不让随便运行网上下载的脚本，这句就是临时放行，只对这一条命令有效，非常安全。

  3. -c "..."
    意思：执行引号里的内容

  4. irm https://astral.sh/uv/install.ps1

    • irm = Invoke-RestMethod
    • 意思：去这个网址下载 uv 的安装脚本
    • 相当于：打开网页 → 复制安装代码

  5. | iex

    • | = 管道，把前面的结果传给后面
    • iex = Invoke-Expression
    • 意思：立即执行刚才下载的安装脚本

整句话连起来的意思
让 PowerShell 临时放行安全限制 → 下载 uv 安装脚本 → 直接运行安装

就是一键自动安装 uv，不需要你手动下载、点下一步、配置环境变量，全部自动完成。

方式二：通过 pip 安装（已有 Python）

pip install uv
# 或 pipx（隔离环境）
pipx install uv

验证安装是否成功

另启动shell窗口，执行下面命令：

uv --version

输出版本号，如下图，表示成功：

快速安装-macOS/Linux 系统

curl -LsSf https://astral.sh/uv/install.sh | sh

高级安装-windows

安装到指定路径

如：安装到 D:\devtools\uv 路径，启动 PowerShell，执行下面命令：

powershell -ExecutionPolicy ByPass -c {$env:UV_INSTALL_DIR = "D:\devtools\uv";irm https://astral.sh/uv/install.ps1 | iex}

修改默认路径

安装后，在系统环境变量（用户变量）里加 3 个变量：

变量名 示例值
UV_PYTHON_INSTALL_DIR D:\devtools\uv_python
UV_CACHE_DIR D:\devtools\uv_cache
UV_TOOL_DIR D:\devtools\uv_tools

解释：

  • UV_PYTHON_INSTALL_DIR：uv 下载安装的 Python 保存路径

  • UV_CACHE_DIR：uv 下载的所有包缓存路径

  • UV_TOOL_DIR：uv 安装的工具（ruff、black、jupyter）的路径

查看配置路径是否成功

另开启一个 shell，执行下面命令，看输出的路径是不是上面环境变量的：

uv python dir

uv cache dir

uv tool dir

更新uv

一键更新 uv

uv self update

指定国内源

安装python、库时，默认从国外服务器下载，有时速度很慢，甚至网络不稳定导致下载一半中断，要改为国内源

永久设置国内源（推荐）

配置后，安装python、库时，永久使用国内源

在文件夹地址栏输入下面路径：

%APPDATA%

敲回车，编程下面路径：

C:\Users\mym\AppData\Roaming

查看该目录下是否有下面文件夹，没有就创建：

uv

在 %APPDATA%\uv 目录下，创建 uv.toml 文件，内容如下：

# 配置 Python 解释器下载源
python-install-mirror = "https://registry.npmmirror.com/-/binary/python-build-standalone/"

# 配置 PyPI 包下载源 (例如：阿里云)
[[index]]
url = "https://mirrors.aliyun.com/pypi/simple/"
default = true

国内常用源列表

阿里：https://mirrors.aliyun.com/pypi/simple/
华为：https://mirrors.huaweicloud.com/pypi/simple/
腾讯云：https://mirrors.cloud.tencent.com/pypi/simple/

临时用一次国内源（单次有效）

uv install --index-url https://pypi.tuna.tsinghua.edu.cn/simple/

uv add requests --index-url https://pypi.tuna.tsinghua.edu.cn/simple/

查看是否设置成功

打开一个新的终端窗口（确保加载了最新配置）。
运行以下命令（以安装 numpy 为例）：

pip install numpy --verbose

注意：加上 --verbose 可以看到更详细的调试信息。

观察输出内容：
✅ 生效了： 你会看到类似 Using index url: https://mirrors.aliyun.com/pypi/simple/ 的提示，或者下载链接显示的是 mirrors.aliyun.com

❌ 没生效： 如果显示 pypi.org 或者下载速度极慢，说明配置未命中。

原文出处：/show_1GW3oW1w2ExJ.html

吉ICP备15003043号