使用PyInstaller编译的PyQt5简易GUI在macOS和Windows下呈现GTK样式

这问题我之前调试PyQt打包时也碰到过类似的，大概率是PyInstaller打包过程中没正确包含Qt的样式资源，或者系统层面的样式配置没被正确加载。给你几个实用的排查和解决方向：

• 显式指定Qt应用样式
  在你的PyQt5代码里，初始化QApplication之后，手动设置Qt的内置样式，避免系统 fallback 到老旧的GTK样式。比如：

  from PyQt5.QtWidgets import QApplication
  import sys
  
  app = QApplication(sys.argv)
  # 指定样式，Fusion是跨平台的现代样式，也可对应平台选WindowsVista/Macintosh
  app.setStyle('Fusion')
  # 后续的窗口初始化代码...
  

  这样即使打包时样式资源有缺失，也能强制使用Qt自带的现代样式。

• 确保PyInstaller包含Qt的样式插件
  PyQt5的样式文件存放在PyQt5/Qt/plugins/styles目录下，PyInstaller默认可能没把这个目录打包进去。你可以手动修改生成的spec文件，添加样式资源的引用：

  import os
  from PyQt5 import QtCore
  
  PYQT5_PATH = os.path.dirname(QtCore.__file__)
  a = Analysis(
      # 你的其他配置...
      datas=[
          (os.path.join(PYQT5_PATH, 'Qt', 'plugins', 'styles'), 'styles'),
      ],
      # 其他参数...
  )
  

  然后用pyinstaller your_app.spec重新打包。如果不想改spec文件，也可以用命令行参数：

  # Windows用分号分隔路径，macOS/Linux用冒号
  pyinstaller --add-data "path/to/PyQt5/Qt/plugins/styles;styles" your_app.py
  

• 检查版本兼容性
  Python3.6.4属于比较老的版本，对应的PyQt5和PyInstaller版本可能存在兼容性问题。建议：

  • 安装适配Python3.6的PyQt5版本（比如PyQt5.12.x，这是支持Python3.6的最后一个大版本）
  • 搭配对应版本的PyInstaller（比如PyInstaller3.6，这个版本对Python3.6的支持比较稳定）

• Windows平台额外排查
  Windows下打包时容易缺失Qt的平台插件（比如qwindows.dll），这也会导致样式异常。同样需要把PyQt5/Qt/plugins/platforms目录打包进去，在spec文件的datas里添加：

  datas=[
      (os.path.join(PYQT5_PATH, 'Qt', 'plugins', 'platforms'), 'platforms'),
  ],
  

• macOS平台尝试onedir模式
  如果用--onefile打包出现问题，先试试--onedir（生成文件夹形式的包），这种模式下资源加载更稳定。如果onedir模式下样式正常，再排查onefile模式下的资源路径问题。

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