Windows环境下Kivy模块安装失败,寻求解决方案
解决Kivy安装时的系列报错问题
我来帮你一步步搞定这些Kivy安装的糟心事,这些报错我之前折腾Kivy的时候也碰到过,咱们逐个击破:
1. 解决「fatal: not a git repository (or any of the parent directories): .git」
这个报错是因为pip尝试从Git源码编译Kivy,但咱们根本不需要这么做——直接用预编译的wheel包就能跳过这个环节,后面我会给你加个参数强制用预编译包,彻底避免这个问题。
2. 解决「invalid command 'bdist_wheel'」且wheel包不可用
这个纯粹是基础工具没装到位!bdist_wheel是Python构建wheel包的命令,你的环境里缺少wheel和最新版的setuptools。先把这些补全:
pip install --upgrade pip setuptools wheel
3. 解决「pkg-config命令未被识别」
pkg-config是Linux下常用的依赖检测工具,但Windows默认没有。这个报错同样是因为触发了源码编译流程,只要咱们用预编译包,就完全不需要这个工具。另外,确保你装全了Kivy的所有官方依赖包,不要漏了sdl2。
4. 解决多个.pyx文件的config.pxi依赖未解决
这是Cython版本不兼容或者源码编译时配置文件缺失导致的。Kivy对Cython版本有严格要求,不要随便装最新版,咱们指定一个稳定兼容的版本:
pip install cython==0.29.36
修正后的完整安装流程(Windows + Python 3.7 64位)
按照这个顺序来,基本能避开所有坑:
- 先升级基础工具,确保构建环境没问题:
pip install --upgrade pip setuptools wheel - 安装指定版本的Cython,避免版本冲突:
pip install cython==0.29.36 - 创建并激活虚拟环境(你原来的这步是对的):
python -m virtualenv kivy_env kivy_env\Scripts\activate - 安装Kivy的所有必需依赖包(补全了你之前漏的
sdl2):pip install kivy_deps.sdl2==0.1.* kivy_deps.gstreamer==0.1.* kivy_deps.angle==0.1.* - 强制安装预编译的Kivy包,彻底跳过源码编译:
pip install kivy --only-binary :all:
额外备选方案
如果上面的步骤还是不行,试试用conda安装(需要先装Anaconda/Miniconda):
conda install -c conda-forge kivy
conda会自动处理所有依赖,包括那些Windows下的特殊工具,省心很多。
内容的提问来源于stack exchange,提问作者uday kiran
相关产品推荐
相关产品推荐

