PyQt经PyInstaller编译后在macOS上外观老旧的问题求助

This is a super common headache with PyQt + PyInstaller—let’s get that clean, modern UI back in your compiled app:

Root Cause #

When running your script directly, PyQt automatically loads your system’s native Qt style (like the sleek Windows 10/11 look). But when you compile with PyInstaller, it often omits the Qt style plugins needed to access that native style, so the app falls back to the old XP-era "Windows" style as a default.

Solutions (Ordered by Reliability) #

1. Force the Fusion Style (Most Recommended) #

Qt includes a built-in cross-platform modern style called Fusion that doesn’t depend on system-specific plugins. Add just one line to your code, and your UI will look identical whether you’re running the script or the compiled exe:

from PyQt5.QtWidgets import QApplication
import sys

if __name__ == "__main__":
    app = QApplication(sys.argv)
    # Lock in Fusion style for consistent modern UI
    app.setStyle("Fusion")
    
    # Initialize your quiz window/widgets here
    # quiz_window = YourQuizMainWindow()
    # quiz_window.show()
    
    sys.exit(app.exec_())

This is the simplest, most reliable fix—it ensures your app looks consistent across all systems, not just your development machine.

2. Package Qt Style Plugins with PyInstaller #

If you want to stick with your system’s native style (instead of Fusion), you need to tell PyInstaller to include the Qt style plugins. These live in your PyQt5 installation’s plugins/styles folder.

Update your PyInstaller command to add these files:

pyinstaller quiz.py --onefile --windowed --add-data questions.csv:. --add-data "<path-to-your-PyQt5>/Qt/plugins/styles/*;styles"

Replace <path-to-your-PyQt5> with the actual path (e.g., C:/Python39/Lib/site-packages/PyQt5 on Windows). Alternatively, use the --collect-all flag to grab all PyQt5 dependencies (note: this will increase your exe size):

pyinstaller quiz.py --onefile --windowed --add-data questions.csv:. --collect-all PyQt5

3. Check System Style Access (Rare Edge Case) #

In some restricted environments, the compiled exe might lack permission to access system style files. If the above methods fail, verify your app can read from Qt’s system directories—but this is unlikely for most standard setups.

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