pip报connection error的常见触发点是pip试图连接错误host（如files.pythonhosted.org或pypi.ngc.nvidia.com），根源多为源配置错误、dns解析失败或残留代理/镜像配置；需先通过curl和nslookup定位问题，再清理pip配置文件、环境变量及trusted-host设置。
pip报Connection error的常见触发点
绝大多数Connection error不是网络彻底断开，而是 pip 在连接某个特定 host 时失败，比如 files.pythonhosted.org、pypi.org 或 pypi.ngc.nvidia.com。关键要看错误信息里明确写的 host —— 它直接暴露了问题源头：是源配置错了，还是 DNS/代理卡在了某一层。
先确认到底是哪个 host 连不上
错误里总会出现类似这样的片段：Connection to pypi.ngc.nvidia.com timed out 或 Name or service not known。前者说明 pip 正试图连 NVIDIA 的镜像（常见于某些预装 CUDA 的 Docker 镜像），后者大概率是 DNS 解析失败。
- 用
curl -v https://pypi.org/simple/手动测试能否通，比ping pypi.org更可靠（因为 pip 走 HTTPS） - 如果
curl成功但 pip 失败，基本可锁定是 pip 自身配置干扰（如残留代理、错误 index-url） - 如果
curl也失败，再查 DNS：nslookup files.pythonhosted.org；若返回 NXDOMAIN 或超时，就得改系统 DNS 或加--trusted-host
快速清理 pip 配置残留
很多 Connection error 其实是 pip 配置文件里存了失效的 index-url 或 proxy，导致它固执地往一个根本不存在的地址发请求。别只关代理软件，要清配置。
- 删掉所有可能的配置文件：
rm -f ~/.pip/pip.conf /etc/xdg/pip/pip.conf /opt/conda/pip.conf - 检查环境变量：
env | grep -i proxy，如有输出，临时清空：unset HTTP_PROXY HTTPS_PROXY - 验证当前生效配置：
pip config list，确保只看到干净的global.index-url=https://pypi.org/simple（没有多余 trusted-host 或 proxy）
遇到 Name or service not known 就别硬扛 DNS
这个错误本质是系统没把域名转成 IP，pip 卡在第一步。等 DNS 修复或换网络不现实，得绕过去。
- 优先加
--trusted-host同时指定 host：pip install requests --trusted-host pypi.org --trusted-host files.pythonhosted.org - 如果想一劳永逸，把这两行写进 pip 配置（注意不是只写
index-url）：[global] index-url = https://pypi.org/simple trusted-host = pypi.org trusted-host = files.pythonhosted.org
- 别用
--trusted-host pypi.tuna.tsinghua.edu.cn配清华源——清华源本身不需要额外信任，只有官方源的子域名才需要
真正麻烦的不是连不上，而是 pip 在多个配置层之间反复横跳，让你以为换了源就万事大吉，结果它还在偷偷读某个 Docker 镜像里带的旧配置。每次看到 Connection error，第一反应不该是“换源”，而是“它到底想连谁”。
