国内使用UV的代理设置指南
在使用 UV 进行软件包管理和 Python 安装时，由于网络环境的限制，国内用户通常需要设置代理或镜像来加速下载过程。本文将详细介绍如何在不同场景下设置国内加速镜像。
一、安装第三方包时的镜像设置¶
在使用 uv add 命令安装第三方包时，有两种方法可以设置国内加速镜像：
1. 直接在命令中指定镜像¶
-
使用
--index参数：对应的环境变量为
UV_INDEX。 -
使用
--default-index参数：对应的环境变量为
UV_DEFAULT_INDEX。
区别：
-
UV_INDEX可以设置多个索引源，多个索引源之间以空格分开，适用于同时使用多个索引源（如公司内部私有索引）。 -
UV_DEFAULT_INDEX只能设置一个索引源，用于替换默认的 PyPI 源。
建议：一般情况下，我们只需配置 UV_DEFAULT_INDEX 即可，常用的镜像源有：
-
清华源:
https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple -
阿里源:
https://mirrors.aliyun.com/pypi/simple/
2. 设置环境变量¶
通过设置环境变量，可以在全局范围内应用镜像源，避免每次安装时都需要指定。
二、安装 Python 时的镜像设置¶
UV 提供了通过 GitHub Releases 下载 Python 的功能，可以通过以下两个参数和环境变量来设置镜像：
1. --mirror 参数¶
用于设置 CPython 的安装包镜像，可以通过设置环境变量 UV_PYTHON_INSTALL_MIRROR 来指定下载镜像。
2. --pypy-mirror 参数¶
用于设置 PyPy 的安装包镜像，可以通过设置环境变量 UV_PYPY_INSTALL_MIRROR 来指定下载镜像。
CPython 与 PyPy 的主要区别：
| 维度 | CPython | PyPy |
| 实现语言 | C 语言编写，官方标准解释器 | RPython 编写，基于 JIT 编译技术 |
| 性能表现 | 解释执行字节码，性能较低 | JIT 编译热点代码为机器码，性能提升 3-4 倍 |
| 内存管理 | 引用计数 + GIL，存在内存碎片问题 | 增量垃圾回收 + 分代回收，无 GIL 限制 |
| 并发支持 | 单线程并发（GIL 限制多线程性能） | 支持微线程（Stackless 模型），适合高并发场景 |
| 生态系统兼容性 | 完整支持所有 Python 库 | 兼容大部分纯 Python 库，对 C 扩展库支持有限 |
| 典型应用场景 | Web 服务、自动化脚本、科学计算 | 数值计算、长时间运行的服务、高并发 API 服务器 |
| 启动时间 | 快速启动 | 需 JIT 预热期 |
注意：目前国内还没有一个完全同步的下载镜像，南京大学的镜像站提供了 UV 的最新下载：
- 镜像地址:
https://mirror.nju.edu.cn/github-release/indygreg/python-build-standalone/
三、总结¶
-
UV_PYTHON_INSTALL_MIRROR：用于设置使用
uv python install命令下载安装 Python 时的镜像。 -
UV_DEFAULT_INDEX：用于设置使用
uv add命令安装第三方包时的镜像。 -
UV_INDEX：用于设置额外的安装镜像，如公司内部的包索引地址。
建议：如果你的网络环境可以正常访问 GitHub，则无需设置镜像。如果访问不了，可以设置南京大学的下载镜像，并配置 UV_DEFAULT_INDEX 为阿里源或清华源来加速 uv add（等同于 pip install）的安装过程。
通过合理设置镜像源，可以显著提升在国内使用 UV 进行软件包管理和 Python 安装的效率。
