先别急着更换包源

pip install 失败可能发生在下载前，也可能是已经取得包后构建失败。No matching distribution found 不必然是网络故障，还可能是 Python 版本、操作系统、架构或你指定的版本没有匹配文件。编译器缺失、磁盘空间不足、权限错误也不应靠换节点解决。

第一步：确认你实际使用的 Python 环境

在目标虚拟环境中运行；Windows 可使用该环境的 python.exe
python --version
python -m pip --version
python -c "import sys; print(sys.executable)"
python -m pip config debug

python -m pip 将 pip 与当前解释器对应起来，避免命令行里的 pip 指向另一套环境。config debug 会显示配置来源及可能包含秘密的值，只在本地检查，分享前脱敏。检查是否激活虚拟环境，以及 IDE、终端和远端容器是否其实用了不同 Python。

错误线索优先检查
ProxyError / connection refused代理地址、端口和运行状态
连接超时 / DNS 失败索引或文件主机的访问路径
CERTIFICATE_VERIFY_FAILED时间、CA 信任链和 TLS 实现
No matching distribution索引查询是否成功、Python 兼容性及版本约束
Failed building wheel构建依赖、编译器和目标包的构建日志

第二步：单次指定代理查询公开索引

只查询版本，不安装软件；适用于支持 pip index 的版本
python -m pip index versions pip --index-url https://pypi.org/simple --proxy http://127.0.0.1:7890 --timeout 15 --retries 0

7890 必须换成真实 HTTP/mixed 端口。若 pip 太旧没有 index 子命令，先按当前版本的官方说明选择等价查询，不要将“没有该命令”误认为网络故障。这条命令检验公开索引，但实际安装还可能访问文件下载域名、Git 或构建依赖来源。

如果项目使用私有索引，应先在公开目标完成不带私有凭据的诊断，再按组织要求测试私有地址。不要为了方便额外添加陌生索引；同名包可能来自不同来源，网络排障不应顺便改变依赖的信任来源。

第三步：检查谁覆盖了你的设置

pip 官方说明中，命令行选项通常优先于环境变量，再到配置文件；配置还分全局、用户和虚拟环境范围，PIP_CONFIG_FILE 可指定额外来源。环境里旧的 PIP_PROXY、索引变量或配置文件，可能让你以为修改无效。先查 debug 的来源，再只改对应项。

  1. 优先保留单次 --proxy 进行诊断，不急着写入每个终端启动文件。
  2. 确需持久化时，记录原值与作用域，只保存必要设置。含账号密码的代理 URL 不应进入项目仓库。
  3. 遇到 TLS 错误时保留验证，核对系统时间和可信 CA；不要使用 trusted-host 或关闭证书检查来掩盖问题。受管理网络按管理员提供的证书流程处理。

验收与回退

在原虚拟环境中重试原来失败的包和版本，区分下载成功与构建成功。确认无需改变项目的版本约束、锁定文件或使用 sudo pip。结束后撤销单次测试之外新增的持久变量和配置；原来有值的恢复原值，原来没有的才删除。再次启动终端，确保没有留下指向已关闭本地端口的代理。