修改 uv Python 包管理器的镜像源

uv 是 Rust 编写的快速 Python 包管理器,要修改其镜像源可以通过以下几种方式:

1. 通过环境变量设置镜像源

uv 支持通过环境变量来配置镜像源:

# 设置 PyPI 镜像源(适用于包下载)
export UV_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"

# 设置 pip 工具本身的下载镜像(如果需要)
export UV_PIP_DOWNLOAD_URL="https://mirrors.aliyun.com/pypi/simple/"

2. 通过配置文件设置

uv 会读取以下位置的配置文件(按优先级从高到低):

  • UV_CONFIG_FILE 环境变量指定的文件
  • ./uv.toml
  • ~/.uv/uv.toml
  • ~/.config/uv/uv.toml

在配置文件中添加:

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

3. 常用国内镜像源

以下是一些常用的国内镜像源,可以选择一个替换上面的 URL:

  • 清华大学:https://pypi.tuna.tsinghua.edu.cn/simple
  • 阿里云:https://mirrors.aliyun.com/pypi/simple/
  • 腾讯云:https://mirrors.cloud.tencent.com/pypi/simple
  • 华为云:https://repo.huaweicloud.com/repository/pypi/simple
  • 豆瓣:https://pypi.doubanio.com/simple/

4. 验证配置是否生效

运行以下命令查看当前配置:

uv pip config list

或者尝试安装一个包来测试:

uv pip install numpy -v