M1芯片MacOS下PyQt6经PyInstaller打包后无法启动求助

1. 统一架构适配 #

• 确认Python、PyQt6、PyInstaller三者架构完全一致（x86_64或arm64）。终端执行python3 -c "import sys; print(sys.maxsize > 2**32)"，返回True代表64位；再执行sysctl -n machdep.cpu.brand_string查看CPU架构。
• M系列芯片用户，尝试用Rosetta 2运行终端打包：右键终端→显示简介→勾选“使用Rosetta打开”，重新创建虚拟环境、安装依赖后再打包。

2. 调整PyInstaller打包参数 #

• 强制指定Qt插件路径，打包命令追加：--add-data "$(python3 -c 'import PyQt6; print(PyQt6.__path__[0])')/plugins:PyQt6/plugins"
• 禁用二进制符号剥离，添加参数：--no-strip，避免因符号表丢失导致的内存访问异常，同时方便后续调试。
• 运行打包后的App前，在终端手动指定Qt平台插件路径：export QT_QPA_PLATFORM_PLUGIN_PATH=/你的App路径/Contents/MacOS/PyQt6/plugins/platforms，再启动App验证。

3. 启用调试日志定位问题 #

• 打包时添加--log-level DEBUG，查看打包过程中是否有依赖缺失或警告信息。
• 在终端直接运行App二进制文件：./你的App.app/Contents/MacOS/你的App，查看实时输出的错误日志，大概率能找到Qt插件加载失败的具体原因。

4. 修复动态库依赖路径 #

• 用otool -L ./你的App.app/Contents/MacOS/你的App检查主二进制文件的依赖库，确保所有Qt相关库的路径都是@executable_path/../Frameworks/开头的相对路径。
• 若存在绝对路径，用install_name_tool修正，示例：install_name_tool -change /usr/local/opt/qt6/lib/QtCore.framework/Versions/A/QtCore @executable_path/../Frameworks/QtCore.framework/Versions/A/QtCore ./你的App.app/Contents/MacOS/你的App，对所有异常路径的Qt库执行此操作。

5. 切换稳定版本组合 #

• 尝试Python 3.10 + PyQt6 6.4.2 + PyInstaller 5.10.1，该组合在Mac平台有大量稳定运行案例，避开最新版本可能存在的兼容性bug。

6. 极简代码测试定位 #

• 用最基础的代码打包测试，排除代码层面问题：

import sys
from PyQt6.QtWidgets import QApplication, QWidget

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = QWidget()
    window.show()
    sys.exit(app.exec())

若此代码打包后仍崩溃，说明是环境问题；若正常，再逐步添加原代码模块，定位触发崩溃的功能点。

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