能否在Python包的dependency_links中定义镜像仓库作为依赖备选？

首先得给你浇个冷水：dependency_links这条路走不通，而且现在已经被彻底废弃了。

为什么dependency_links不行？ #

就算在它还被支持的年代，这个参数的设计目的也只是用来添加非PyPI源的单个包链接（比如GitHub上的某个包的tarball地址），根本没有“故障转移”的逻辑——哪怕你给同一个包写了多个URL，pip只会尝试下载第一个，失败了就直接报错，不会自动去试第二个。更别说现在pip从19.0版本开始就彻底移除了对dependency_links的支持，setuptools也在逐步淘汰这个参数，现在用它完全是白费功夫。

正确的实现方式：用pip的多索引源配置 #

要实现“主镜像失败自动切换备选镜像”的需求，应该用pip的官方多索引源机制，有几种常用方式：

1. 配置pip全局配置文件

这是最持久的方式，一次配置后所有pip安装都会生效：

• Linux/macOS：在~/.config/pip/pip.conf文件里添加（没有就新建）：

  [global]
  index-url = https://你的主镜像地址/simple/
  extra-index-url = https://你的备选镜像地址/simple/
  

• Windows：在%APPDATA%\pip\pip.ini文件里添加同样的内容。

pip会优先从index-url指定的源查找包，如果这个源不可达或者找不到对应包，会自动尝试extra-index-url里的备选源。

2. 在requirements.txt里临时指定

如果只是针对某个项目的需求，可以直接在requirements.txt头部加源配置：

--index-url https://你的主镜像地址/simple/
--extra-index-url https://你的备选镜像地址/simple/
# 下面写你的依赖包
your-package==1.0.0
another-package>=2.0.0

执行pip install -r requirements.txt时，pip就会按这个配置的源顺序查找包。

3. 用环境变量临时配置

如果只是临时测试或者单次安装，可以用环境变量指定：

• Linux/macOS终端：

  export PIP_INDEX_URL=https://你的主镜像地址/simple/
  export PIP_EXTRA_INDEX_URL=https://你的备选镜像地址/simple/
  pip install your-package==1.0.0
  

• Windows命令提示符：

  set PIP_INDEX_URL=https://你的主镜像地址/simple/
  set PIP_EXTRA_INDEX_URL=https://你的备选镜像地址/simple/
  pip install your-package==1.0.0
  

额外提醒 #

不要在setup.py里硬编码镜像源——这是部署环境的配置，不是包本身的定义，硬编码会限制用户的使用场景，不符合Python包的最佳实践。

内容的提问来源于stack exchange，提问作者0x416e746f6e