uv设置镜像源

时间: 2025-10-25T12:00:00+08:00

摘要: "又到了纠结如何设置镜像源的时候"

前言

和 pip 类似，uv 也是从 pypi 下载包，但是有时候国内无法下载，就需要设置镜像源。

通过 export 声明环境变量:

export UV_DEFAULT_INDEX=镜像源地址

或者在命令行使用 --default-index:

uv add requests --default-index 镜像源地址

可以把上面提到的 UV_DEFUALT_INDEX 写进 ~/.profile（或 ~/.bashrc、~/.zshrc）里。

或者通过配置文件的方式，uv 会在当前项目或全局配置中读取 uv.toml。你可以在其中定义默认索引、额外索引、缓存策略等。

全局配置地址：~/.config/uv/uv.toml

写入内容如下：

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