pip 镜像加速

pip install 在国内网络下的真实体验往往很糟：官方源超时、镜像间歇性不可用、SSL 证书报错，最后错误信息还常常指错方向——你以为是网络问题，其实是包名写错了。这个技能把这类机械但容易出错的排查过程固化成脚本，目标是让你不再手动构造 --index-url 参数反复试错。## 它解决的具体问题- 源不可用时的手动回退：镜像挂了要自己换 URL 重跑，每次安装都在赌哪个源活着- 错误归因困难：SSL: CERTIFICATE_VERIFY_FAILED、Could not find a version、超时混在一起，肉眼难以区分网络、包名与证书问题- 包名与发行名不一致：pip install opencv 和 pip install sklearn 注定失败，正确的包是 opencv-python 与 scikit-learn## 核心能力技能捆绑了三个脚本，位于 scripts/ 目录，执行 pip 相关任务时应优先使用它们，而不是手动拼命令。1. auto_install.py — 自动安装（核心）- 按固定顺序遍历六面镜像链：清华 → 阿里 → 中科大 → 豆瓣 → 腾讯 → 官方 PyPI- 任一镜像失败自动切换下一个，每个镜像 120 秒超时- 错误类型自动分类：NETWORK、NOT_FOUND、SSL、CONFLICT、PERMISSION- SSL 错误自动追加 --trusted-host 重试- 内置包名纠错：opencv → opencv-python、sklearn → scikit-learn- 成功时输出 JSON 摘要（包名、所用镜像、耗时、尝试次数）；全部失败时输出诊断报告，区分「包不存在」与「网络问题」2. speed_test.py — 测速选源逐个测试镜像的下载速度并排序，回答「哪个镜像最快」这类问题，并给出永久配置命令。3. check_mirrors.py — 在线检测快速检测每个镜像是否可达，并额外校验 SSL 证书有效性，适合排查连接错误。安装完成后应按惯例用 import 验证，并把脚本输出的结构化摘要转述给用户，而不是只说一句「装好了」。## 适用边界与注意点- 豆瓣镜像维护不稳定，在链中仅作备用，可能拖慢整体回退- 官方 PyPI 最全但最慢，只作为最后回退，不要指望它改善国内速度- 只有永久配置镜像这类极简操作（pip config set global.index-url）可以不经脚本手动执行- 脚本无法解决代理本身不通、无网络等环境问题；若 PERMISSION 类错误反复出现，建议新建虚拟环境- SSL 重试仍失败时，提示更新 certifi