py2app打包Python应用报IndexError: tuple index out of range错误

• 核心诱因是当前安装的py2app版本未适配Python 3.11的字节码规则，和虚拟环境是否激活无直接关联。Python 3.11调整了字节码指令的参数结构，py2app内置的detect_dunder_file扫描模块仍沿用旧版本逻辑读取字节码参数，访问co_names元组时索引超出实际范围，直接触发IndexError: tuple index out of range。
• VSCode中直接运行代码无异常，是因为常规运行流程不会触发py2app的打包扫描逻辑，只有执行py2app构建命令时才会走到这段存在兼容bug的代码。
• 未激活虚拟环境时触发相同报错，是因为全局Python环境安装的py2app同样为存在兼容问题的旧版本，并非虚拟环境激活失效。
• 你使用的setup.py是py2applet生成的默认标准配置，不存在配置错误，无需调整配置内容。

按优先级依次操作：

• 优先升级py2app至适配Python 3.11的最新版本，在激活的虚拟环境中执行以下命令：

  pip install --upgrade py2app
  

  升级完成后先删除项目目录下旧的build、dist缓存文件夹，再重新执行python setup.py py2app构建即可。
• 若升级后问题仍存在，可直接临时绕过该检测逻辑：打开虚拟环境路径下的venv/lib/python3.11/site-packages/py2app/recipes/detect_dunder_file.py文件，给第25行的索引读取逻辑增加边界判断，或直接注释掉scan_bytecode_loads的递归扫描逻辑——该模块仅用于检测代码中__file__变量引用的兼容性警告，不会影响打包的核心功能。
• 上述方案均无效时，可降级Python版本至3.10.x，重新创建虚拟环境安装所有依赖后再执行打包，py2app对Python 3.10及更早版本的适配不存在该字节码兼容问题。

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