pip install -i 后面必须跟带 /simple/ 结尾的镜像源 url,如 https://mirrors.aliyun.com/pypi/simple/;末尾斜杠不可省略,否则报 404 错误。

直接加 -i 参数就行,不用改配置、不污染环境,适合单次安装或 CI/CD 场景。
pip install -i 后面跟什么地址?
必须是带 /simple/ 结尾的镜像源 URL,不是首页地址。常见可用地址(2026 年实测有效):
- 清华大学:
https://pypi.tuna.tsinghua.edu.cn/simple/ - 阿里云:
https://mirrors.aliyun.com/pypi/simple/ - 中科大:
https://pypi.mirrors.ustc.edu.cn/simple/ - 腾讯云:
https://mirrors.cloud.tencent.com/pypi/simple/
注意:末尾斜杠不能少,simple/ 不能写成 simple 或 simple.html,否则 pip 会报 404 Client Error。
命令格式和常见错误写法
正确写法(空格位置、参数顺序都有要求):
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ requests
容易出错的写法:
-
pip install requests -i https://...——-i必须紧挨install,放后面会被忽略 -
pip install -ihttps://...——-i和 URL 之间必须有空格,否则 pip 解析失败 -
pip install -i https://pypi.tuna.tsinghua.edu.cn/ requests—— 缺少/simple/,返回 404
配合 requirements.txt 时怎么用?
如果要装整个依赖列表,-r 和 -i 可以共存,但顺序固定:
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/
注意点:
-
-i必须写在-r后面,否则只对第一个包生效 - 如果
requirements.txt里写了--index-url或--extra-index-url,它们会覆盖命令行的-i - 某些私有包或带
@ git+的依赖,镜像源不生效,会回退到默认源
为什么有时候加了 -i 还很慢或失败?
不是所有镜像源都同步完整,尤其新发布的包可能延迟数小时。此时可换源重试:
- 清华源更新快,但偶尔因 CDN 节点问题卡住
- 阿里云源稳定性高,适合企业级批量安装
- 中科大源对科研类包(如
numpy、scipy的 wheel)兼容性更好 - 如果遇到
Could not find a version that satisfies...,大概率是该镜像还没同步,换一个试试
临时使用镜像源的关键在于「不依赖本地配置」,但也要清楚它只作用于当前命令——下一次 pip install 不加 -i,就又走官方源了。











