uv教程：安装 作者：马育民 • 2026-08-06 19:12 • 阅读：10001 # 快速安装-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） ```bash pip install uv # 或 pipx（隔离环境） pipx install uv ``` ### 验证安装是否成功 另启动shell窗口，执行下面命令： ```bash uv --version ``` 输出版本号，如下图，表示成功： [](https://www.malaoshi.top/upload/0/0/1GW3FpQ8xA48.png) # 快速安装-macOS/Linux 系统 ```bash 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/ ``` ### 临时用一次国内源（单次有效） ```powershell uv install --index-url https://pypi.tuna.tsinghua.edu.cn/simple/ ``` ```powershell uv add requests --index-url https://pypi.tuna.tsinghua.edu.cn/simple/ ``` ### 查看是否设置成功 打开一个新的终端窗口（确保加载了最新配置）。 运行以下命令（以安装 numpy 为例）： ```bash pip install numpy --verbose ``` **注意：**加上 `--verbose` 可以看到更详细的调试信息。 观察输出内容： ✅ 生效了： 你会看到类似 `Using index url: https://mirrors.aliyun.com/pypi/simple/` 的提示，或者下载链接显示的是 `mirrors.aliyun.com` ❌ 没生效： 如果显示 `pypi.org` 或者下载速度极慢，说明配置未命中。 原文出处：http://www.malaoshi.top/show_1GW3oW1w2ExJ.html