PyQt5 GUI经PyInstaller打包生成的exe无法启动

我之前也碰到过一模一样的情况！命令行跑好好的，打包成exe就只闪个黑框，GUI死活不出来，给你几个亲测有效的排查方向：

• 一定要加窗口模式参数打包
  PyInstaller默认会给程序绑定控制台窗口，对于GUI程序来说，这个参数必须加，不然很可能导致GUI启动异常。打包命令改成这样：
  pyinstaller -w [你的文件路径].py
  这里的-w（或者全称--windowed）就是告诉PyInstaller不要显示控制台，专门适配GUI程序。

• 检查代码入口的正确性
  确认你的PyQt5代码入口部分有没有写对，必须要有完整的QApplication初始化和窗口显示逻辑，比如：

  import sys
  from PyQt5.QtWidgets import QApplication, QMainWindow
  
  class MyGUI(QMainWindow):
      def __init__(self):
          super().__init__()
          # 你的窗口布局、控件设置
  
  if __name__ == "__main__":
      app = QApplication(sys.argv)
      main_window = MyGUI()
      main_window.show()  # 这行千万不能漏！
      sys.exit(app.exec_())
  

  要是少了main_window.show()或者sys.exit(app.exec_())，打包后自然看不到窗口。

• 强制收集PyQt5的所有依赖
  Anaconda环境里的PyQt5结构可能比较特殊，PyInstaller有时候会漏收集依赖文件。可以用--collect-all参数强制打包所有PyQt5相关内容：
  pyinstaller -w --collect-all PyQt5 [你的文件路径].py
  这样能避免因为缺失某个Qt组件导致GUI无法启动。

• 查看具体报错信息
  如果上面的方法都没用，别双击exe，而是打开CMD，导航到exe所在文件夹，直接输入mytest.exe运行。这样控制台不会自动关闭，你就能看到具体的错误提示了——比如某个dll找不到、模块缺失之类的，根据报错再针对性解决就行。

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