1分钟搞定！Python超速工具uv换国内镜像，下载速度飙升10倍

作为搞运维的老手，我太清楚 Python 包下载速度慢是啥滋味了。今天我来教你用 3 行代码给 uv 换上清华或者阿里云的镜像，这样就能跟 pip 那慢吞吞的速度说拜拜啦！

第一步：找到uv的“控制中心”

uv的配置文件默认藏在这里：
o Windows：C:\Users\你的用户名\AppData\Roaming\uv\uv.toml
o Mac/Linux：~/.config/uv/uv.toml

找不到？直接命令行一键创建：

mkdir -p ~/.config/uv && touch ~/.config/uv/uv.toml

第二步：粘贴镜像地址（任选其一）

用记事本/Vim打开配置文件，添加以下内容：

清华源（推荐）：

[[index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true

阿里云源：

[[index]]
url = "https://mirrors.aliyun.com/pypi/simple/"
default = true

第三步：立即生效的偷懒技巧

不想改配置文件？直接在命令行加参数：

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

验证是否成功

安装时看到Using index-url字样即生效：

Using Python 3.13.2 environment at: tt
Resolved 5 packages in 1.16s
Prepared 5 packages in 120ms
Installed 5 packages in 3ms
 + certifi==2025.1.31
 + charset-normalizer==3.4.1
 + idna==3.10
 + requests==2.32.3
 + urllib3==2.3.0

避坑指南

1. Windows用户注意：
   AppData是隐藏文件夹，需打开「查看隐藏项目」选项
2. Mac报错处理：
   如果提示权限不足，执行：

sudo chmod 755 ~/.config/uv/uv.toml

3. 多项目隔离配置：
   在项目根目录创建uv.toml，优先级高于全局配置