使用setup.py安装Kivy时出现IndexError: tuple index out of range错误

错误原因分析 #

从错误日志可以定位两个核心问题：

• Cython版本不兼容：当前使用的Cython 3.0.6不在Kivy 2.2.1支持的版本范围内（官方支持0.24~0.29.33，排除0.27、0.27.2），高版本Cython的API与Kivy的setup脚本不匹配，直接触发了self.sources = args[1]的索引错误。
• Windows依赖缺失：系统缺少pkg-config工具，且SDL2相关子库（SDL、SDL_mixer、SDL_ttf、SDL_image）未安装，这会影响Kivy功能完整性，但当前崩溃的直接诱因是Cython版本问题。

分步解决方案 #

1. 降级Cython到兼容版本 #

先卸载当前不兼容的Cython：

pip uninstall -y cython

安装Kivy官方指定的兼容版本：

pip install -I "cython>=0.24,<=0.29.33,!=0.27,!=0.27.2"

2. 解决Windows环境依赖问题 #

安装SDL2相关依赖

手动下载Kivy官方提供的Windows依赖包，解压后将lib和include目录内容分别复制到Python安装目录对应的Lib和Include文件夹；或通过环境变量指定路径：

set SDL2_INCLUDE_DIR=C:\path\to\SDL2\include
set SDL2_LIB_DIR=C:\path\to\SDL2\lib\x64

处理pkg-config缺失

• 方法一：下载pkg-config工具（如GnuWin32项目提供的版本），将其可执行文件路径添加到系统PATH环境变量。
• 方法二：修改Kivy源码目录下的setup.cfg，添加SDL2路径配置以跳过pkg-config检查：

  [build_ext]
  sdl2_include_dirs = C:\path\to\SDL2\include
  sdl2_lib_dirs = C:\path\to\SDL2\lib\x64
  

3. 重新执行安装命令 #

回到Kivy源码目录，运行安装命令：

python setup.py install --single-version-externally-managed --root=/

若需提前验证编译是否正常，可先执行：

python setup.py build_ext --inplace

内容的提问来源于stack exchange，提问作者Nithish Duraikannan