Python3.8环境下pip安装Kivy出现SSL握手超时，禁用代理仍自动启用
2026-11-6
Kivy安装触发ProxyError的排查解决步骤
第一步：清除pip配置中硬编码的失效代理
触发“手动关代理后，执行pip命令时自动重新启用代理”的核心原因，是此前升级pip、安装pyttsx3时，pip将当时生效的代理地址写入了全局配置；后续无论系统代理是否手动关闭，pip都会强制读取配置中存储的失效代理发起请求。
- 先执行命令查看当前pip的所有生效配置：
pip config list - 只要输出内容里包含
proxy相关条目，直接执行清除命令：pip config unset global.proxy - 再次执行
pip config list确认无proxy类输出，即完成pip侧的代理清除。
第二步：清除终端环境变量中的残留代理
系统手动关闭代理后，已打开的终端会话的环境变量通常不会同步更新，pip启动时会自动读取环境变量中的代理配置：
- 检查环境变量是否有代理残留：
- Windows系统执行：
echo %http_proxy%、echo %https_proxy% - Mac/Linux系统执行：
echo $http_proxy、echo $https_proxy
- Windows系统执行：
- 如有代理值输出，在当前终端窗口执行清除操作：
- Windows系统：
set http_proxy=、set https_proxy= - Mac/Linux系统：
unset http_proxy、unset https_proxy
*注意：清除操作只对当前打开的终端窗口生效，后续执行pip命令必须在清除完变量的同一个窗口操作，不要中途新开窗口（新开窗口会重新加载系统代理配置）。
- Windows系统：
第三步：执行Kivy安装
完成前两步的代理清除后，搭配超时参数、国内镜像源执行安装，避免PyPI官方源握手超时：
- 带国内源的正式安装命令：
pip install kivy -i https://pypi.tuna.tsinghua.edu.cn/simple/ --trusted-host pypi.tuna.tsinghua.edu.cn --default-timeout=120 - 如果遇到SSL证书校验报错，临时应急加信任参数执行：
pip install kivy --trusted-host pypi.org --trusted-host files.pythonhosted.org --default-timeout=120
常见踩坑提示：如果清除完pip配置、环境变量后还是会自动走代理，检查当前安装的Python是否为企业定制镜像版——这类镜像通常会预置全局代理配置，需要手动找到pip.ini（Windows）/pip.conf（Mac/Linux）配置文件，直接删除文件内的proxy相关行即可解决。
内容的提问来源于stack exchange，提问作者user14663859
相关产品推荐
相关产品推荐
