UV更改python源和pypi源

要更改 uv 的下载地址，主要是为了使用国内镜像源来加速下载。这涉及到两个不同的配置，需要分别设置：

• PyPI 源：用于加速下载 Python 第三方包（例如执行 uv add numpy 时）。
• CPython 代理：用于加速下载 Python 解释器本身（例如执行 uv python install 3.12 时）。

最推荐的方法是修改 uv 的全局配置文件，这样可以一劳永逸地为所有项目生效。

🚀 推荐方法：修改全局配置文件

通过创建一个全局配置文件，可以一次性配置好 PyPI 源和 CPython 代理。

1. 找到或创建配置文件
   uv 的全局配置文件名为 uv.toml，在不同系统中的路径如下：

   • Windows: %APPDATA%\uv\uv.toml (通常是 C:\Users\你的用户名\AppData\Roaming\uv\uv.toml)
   • macOS / Linux: ~/.config/uv/uv.toml

   如果 uv 文件夹或 uv.toml 文件不存在，请手动创建它们。

2. 编辑配置文件内容
   用文本编辑器打开 uv.toml 文件，将以下内容复制进去。这个配置同时包含了 PyPI 源和 CPython 代理的加速设置：

   # 1. CPython 代理配置
   # 作用：加速 `uv python install` 下载 Python 解释器
   python-install-mirror = "https://cnb.cool/astral-sh/python-build-standalone/-/releases/download/"# 2. PyPI 源配置
   # 作用：加速 `uv add` 或 `uv pip install` 下载第三方包url = "https://mirrors.cloud.tencent.com/pypi/simple"
   default = true
   

   保存文件后，配置即刻生效。

💡 其他配置方法

除了修改全局配置文件，你也可以通过以下方式进行配置：

• 设置环境变量：设置一个名为 UV_INDEX_URL 或 UV_DEFAULT_INDEX 的环境变量，值为镜像源地址（如 https://pypi.tuna.tsinghua.edu.cn/simple）。此方法仅对 PyPI 源生效。
• 命令行临时指定：在执行命令时通过参数临时指定源，例如 uv add --default-index https://pypi.tuna.tsinghua.edu.cn/simple requests。此方法仅对当前命令生效，且只针对 PyPI 源。

📚 常用国内镜像源地址

你可以根据自己的网络情况选择或替换配置中的镜像源地址：

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