使用 uv 恢复默认官方源,只需在终端执行 uv pip install --index-url https://pypi.org/simple/ 或在配置文件中将 index-url 设为该地址。这能覆盖项目或全局的自定义镜像设置,确保从 pypi 官方仓库拉取依赖。

命令行如何临时指定官方源
通过 --index-url 参数可以在单次命令中强制使用官方源,无需修改配置文件。这种方式适合临时排查因镜像源故障或缓存问题导致的安装失败。

uv pip install requests --index-url https://pypi.org/simple/
运行上述命令后,uv 会直接连接 pypi.org 下载 requests 及其依赖。如果网络通畅,安装将成功完成;若之前配置了国内镜像,此命令会忽略该配置。输出中会显示从官方源获取包的日志信息。
立即学习“Python免费学习笔记(深入)”;
将测试、lint、构建和文档流程编码为命名的Python会话,以便人类和代理每次运行相同的workflow。
配置文件如何永久重置为官方源
在 uv 的全局或项目级配置文件中,将 index-url 设置为 https://pypi.org/simple/ 即可永久恢复默认行为。这适用于希望团队统一使用官方源的场景。

[pip] index-url = "https://pypi.org/simple/"
将上述内容写入 uv.toml 或 .python-version 相关的配置段(具体取决于 uv 版本和配置结构,通常 uv.toml 是主要配置)。保存后,所有后续的 uv pip install 命令都会默认使用官方源,除非再次通过命令行参数覆盖。这确保了环境的一致性,避免了因镜像源不同导致的依赖版本差异。
验证当前使用的源是否已恢复
执行 uv pip config debug 可以查看当前生效的配置来源和值。检查输出中的 index-url 字段,确认其值为 https://pypi.org/simple/。这是验证恢复操作是否成功的直接方法。

















