1分钟搞定!Python超速工具uv换国内镜像，下载速度飙升10倍
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
避坑指南
- Windows用户注意：
AppData是隐藏文件夹，需打开「查看隐藏项目」选项 - Mac报错处理：
如果提示权限不足，执行：
sudo chmod 755 ~/.config/uv/uv.toml- 多项目隔离配置：
在项目根目录创建uv.toml，优先级高于全局配置