安装kivy时提示Failed building wheel for kivy报错无法完成安装求助

报错原因 #

该错误是因为直接通过pip安装kivy时需要从源码编译构建wheel，你的环境缺少对应的编译依赖和系统组件，导致构建失败，同时这也是安装过程耗时很长的原因。

解决步骤 #

1. 优先安装预编译版本Kivy（全系统通用优先方案） #

先升级pip、setuptools、wheel到最新版本，强制优先使用预编译的二进制包安装kivy，跳过源码编译流程：

pip install --upgrade pip setuptools wheel
pip install kivy --prefer-binary

如果上述命令执行失败，再根据你使用的操作系统安装对应的系统前置依赖后再重试：

• Windows系统：无需额外安装系统依赖，直接执行上面两条命令即可，若仍失败可下载对应python版本的kivy离线whl包本地安装
• macOS系统：先通过homebrew安装底层依赖
  brew install sdl2 sdl2_image sdl2_ttf sdl2_mixer gstreamer
  再执行上方两条pip命令安装kivy
• Debian/Ubuntu系列Linux系统：先通过apt安装底层依赖
  sudo apt install python3-dev libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev libportmidi-dev libswscale-dev libavformat-dev libavcodec-dev zlib1g-dev
  再执行上方两条pip命令安装kivy

2. 安装剩余项目依赖 #

kivy安装成功后，执行命令安装剩下的项目依赖即可：
pip install SpeechRecognition googletrans

备选方案 #

如果你不需要使用该项目的GUI交互界面，完全可以跳过kivy安装，仅安装核心功能所需的依赖即可使用语音转文字功能：
pip install SpeechRecognition googletrans

内容的提问来源于stack exchange，提问作者Husnain Sajid