PyInstaller打包Kivy应用报错IndexError：列表索引越界求助

问题重现 #

我在Anaconda基础环境里用PyInstaller打包Kivy应用成.exe完全没问题，但生成的文件夹足足有500MB，实在太臃肿。于是我建了个只装必需依赖的精简环境，结果每次打包运行都报这个错：

IndexError: list index out of range [4160]
Failed to execute script demoplayer

折腾好久都没解决，恳请各位大佬帮忙排查！

我总结了几个大概率能解决问题的方向，你可以逐一尝试： #

1. 先把精简环境的依赖补全

Kivy的依赖不止表面的kivy包，还有一堆隐性依赖（比如SDL2、GStreamer这些底层库），精简环境很容易漏装：

• 先执行这条命令补全核心依赖：

  pip install kivy kivy-deps.sdl2 kivy-deps.glew kivy-deps.gstreamer
  

• 同时把PyInstaller和Kivy更到最新稳定版，版本不兼容也是常见坑：

  pip install --upgrade pyinstaller kivy
  

2. 调整.spec文件的关键配置

精简环境打包出错，大概率是.spec里的隐藏导入或资源路径没配置对：

• 打开你的.spec文件，在hiddenimports里补上Kivy的核心模块（避免打包时漏导）：

  hiddenimports=['kivy', 'kivy.uix', 'kivy.graphics', 'kivy.core.window', 'kivy.core.image'],
  

• 如果你的应用有自定义资源（字体、图标、图片等），一定要在datas里指定路径，比如：

  datas=[('./assets', 'assets')],  # 左边是本地资源路径，右边是打包后对应的路径
  

• 如果之前的.spec是从基础环境生成的，建议删掉重新生成，带上--windowed（或--console）参数：

  pyinstaller --name demoplayer --windowed main.py
  

3. 排查资源加载的路径问题

IndexError十有八九是打包后找不到某个资源，导致代码里的列表访问越界：

• 检查你的代码里有没有硬编码的绝对路径（比如C:/xxx/xxx.png），打包后这些路径肯定失效，换成相对路径再用Kivy的资源查找函数：

  from kivy.resources import resource_find
  img_path = resource_find('logo.png')
  

• 用--console参数打包成带控制台的版本，运行时能看到完整的错误堆栈，直接定位到哪一行代码出问题，效率会高很多。

4. 清理缓存后重新打包

有时候环境里的缓存文件会搞出莫名其妙的问题：

• 删掉PyInstaller生成的build、dist文件夹和.spec文件，从头来：

  rm -rf build dist demoplayer.spec
  pyinstaller --windowed main.py
  

• 顺便清理下Anaconda的缓存：

  conda clean -a
  

如果尝试完这些还没解决，把完整的错误堆栈和你的.spec文件内容贴出来，我再帮你精准定位！

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