You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Windows 10 系统 Python 3.10 执行pip install安装依赖包卡住报错

问题根因

你遇到的安装失败问题核心来自两个层面:

  • 版本适配问题:Python 3.10的发版时间晚于Kivy 2.0.0、旧版matplotlib的发版周期,这些库的官方预编译二进制包(wheel)尚未适配Python 3.10版本。pip找不到对应版本的依赖包时会自动拉取源码包尝试本地编译,Windows系统默认没有配置C++编译环境的情况下就会触发报错,甚至出现卡死现象。
  • 工具版本缺陷:你当前使用的pip版本较低,对高版本Python的依赖解析逻辑存在漏洞,也会提升安装失败的概率。
修复步骤

步骤1:升级基础包管理工具

首先在激活虚拟环境的状态下执行以下命令,升级pip、setuptools、wheel到最新版本:
python -m pip install --upgrade pip setuptools wheel
升级完成后先尝试重新安装目标库,部分适配问题可直接解决。

步骤2:修复Kivy安装失败问题

Kivy 2.0.0及更早版本无Python 3.10适配包,可二选一执行以下方案:

  • 方案一:安装适配Python 3.10的Kivy预览版本,执行命令:
    py -m pip install kivy==2.1.0rc1 kivy[base] kivy_examples
  • 方案二:将本地Python版本降级到3.9,Kivy 2.0.0对Python 3.9有完整官方适配,直接执行原安装命令即可成功。

步骤3:修复matplotlib安装失败问题

matplotlib从3.4.3版本开始适配Python 3.10,执行以下命令安装对应版本即可:
py -m pip install matplotlib>=3.4.3

步骤4:通用编译环境配置(可选)

如果后续仍有其他库需要源码编译安装,可安装微软Visual Studio Build Tools,勾选「使用C++的桌面开发」组件包,安装完成后重启终端即可支持Python库的本地编译操作。

内容的提问来源于stack exchange,提问作者Adam Silver

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.30 16:45:03