Big Sur系统下PyInstaller打包PyQt程序无法生成可用.app文件的问题

我之前在Big Sur上打包PyQt5应用时，也碰到过和你完全一样的问题——打包完成后图标闪一下就消失，终端运行直接报Segmentation fault: 11。这个问题基本是PyInstaller和Big Sur的兼容性适配问题，尤其是针对Qt框架的打包逻辑。给你几个亲测有效的解决办法：

1. 升级PyInstaller到适配Big Sur的版本 #

旧版本的PyInstaller对Big Sur的系统架构和Qt依赖处理有缺陷，优先尝试升级到最新稳定版，甚至开发版：

• 升级到最新稳定版：

  pip install --upgrade pyinstaller
  

• 如果稳定版还是不行，试试安装开发分支的版本（修复了很多Big Sur相关的bug）：

  pip install https://github.com/pyinstaller/pyinstaller/archive/develop.zip
  

2. 打包时补充Qt相关的隐藏依赖和标识 #

PyInstaller有时候无法自动识别PyQt5的sip模块，而且Big Sur对应用包的标识符有更严格的要求，打包时加上这些参数：

pyinstaller my_script.py --onefile --windowed --hidden-import PyQt5.sip --osx-bundle-identifier com.yourname.miles2km

• --hidden-import PyQt5.sip：强制打包PyQt5的核心依赖模块
• --osx-bundle-identifier：给应用指定一个唯一的标识符，避免Big Sur的安全机制拦截

3. 确保Python和PyQt5版本匹配且适配Big Sur #

有时候PyQt5的安装包不是针对Big Sur编译的，导致打包后运行出错。可以重新安装适配的PyQt5：

pip uninstall -y PyQt5
pip install PyQt5

如果用conda环境的话，换成conda安装会更稳定：

conda install pyqt

4. 先打包成控制台程序调试 #

去掉--windowed参数，打包成带控制台的版本，这样能看到更详细的错误输出，方便定位问题：

pyinstaller my_script.py --onefile

运行生成的可执行文件，如果控制台能正常运行，再结合上面的参数重新添加--windowed打包。

5. 手动添加Qt的平台插件 #

极端情况下，PyInstaller可能漏掉了Qt的platforms插件，导致无法初始化窗口。找到你Python环境里的PyQt5插件路径（比如/Library/Frameworks/Python.framework/Versions/3.9/lib/python3.9/site-packages/PyQt5/Qt/plugins），打包时把platforms文件夹添加进去：

pyinstaller my_script.py --onefile --windowed --add-data "/Library/Frameworks/Python.framework/Versions/3.9/lib/python3.9/site-packages/PyQt5/Qt/plugins/platforms:platforms"

我当时就是通过升级PyInstaller到最新开发版，再加上--hidden-import PyQt5.sip的参数解决了问题，你可以先试试前两个方法，大概率能搞定。

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