永久修改python uv的下载源需要配置环境变量 uv_index_url 或 uv_extra_index_url,或者在项目中创建 .pypirc 文件。设置后,uv 会自动从指定地址拉取包,无需每次手动添加参数。

如何通过环境变量全局配置默认索引?
通过设置系统级环境变量 UV_INDEX_URL 可以覆盖默认的 PyPI 地址。这是最直接的永久生效方式,适用于所有项目。

export UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/ uv pip install requests
上述命令中,UV_INDEX_URL 指向阿里云镜像。执行 uv pip install 时,uv 会优先使用该 URL 解析依赖。若需保留官方源作为备用,可设置 UV_EXTRA_INDEX_URL,两者同时存在时优先使用前者。
立即学习“Python免费学习笔记(深入)”;
如何在特定项目中配置私有或替代索引?
对于需要隔离环境的项目,可以在项目根目录创建 .pypirc 配置文件。该文件遵循标准 Python 配置格式,指定 index-url 即可让 uv 识别。

[pypi] index-url = https://mirrors.aliyun.com/pypi/simple/
当 uv 在项目目录下运行时,会读取 .pypirc 中的 index-url。这种方式不影响其他项目,适合多环境管理。注意文件名必须为 .pypirc 且位于项目根目录。
配置后如何验证当前使用的索引源?
可以通过运行 uv pip config debug 查看当前生效的配置来源。该命令会列出环境变量、配置文件及命令行参数的优先级状态,确认索引 URL 是否已正确加载。


















