Python 3.10生成.exe文件时遇IndexError: tuple index out of range问题求助

架构老林

2026-6-24

Python 3.10 生成.exe时「IndexError: tuple index out of range」的解决方案

以下是几个经过验证的解决方向，按优先级尝试：

升级PyInstaller到兼容版本
早期PyInstaller版本对Python 3.10支持不完善，直接执行命令升级：
```
pip install --upgrade pyinstaller
```
确保PyInstaller版本≥4.8（该版本开始正式支持Python 3.10）。
修复PyInstaller内置脚本（升级后仍报错时）
找到PyInstaller安装目录下的pyi_rth_pkgutil.py文件，找到以下代码段：
```
pkg_paths = getattr(pkg, '__path__', None)[0]
```
修改为：
```
pkg_paths = getattr(pkg, '__path__', None)
if pkg_paths and len(pkg_paths) > 0:
    pkg_paths = pkg_paths[0]
else:
    continue
```
保存文件后重新尝试打包。
排除冲突依赖模块
若报错由特定第三方库触发，打包时用--exclude-module参数排除该模块，示例：
```
pyinstaller --exclude-module outdated_lib your_script.py
```
可以通过逐步注释代码、移除依赖的方式排查触发问题的模块。
使用干净虚拟环境打包
全局环境的依赖冲突也可能导致该问题，创建独立虚拟环境重新操作：
1. 创建虚拟环境：
```
python -m venv venv
```
2. 激活虚拟环境：
  - Windows：venv\Scripts\activate
  - Linux/macOS：source venv/bin/activate
3. 安装必要依赖和PyInstaller：
```
pip install -r requirements.txt
pip install pyinstaller
```
4. 重新执行打包命令：
```
pyinstaller your_script.py
```