Pyinstaller打包Python+PyQt5应用后界面显示异常求助

Hey there, let's work through these two annoying issues with your PyQt5 app packaged on macOS—they’re super common when using PyInstaller, so I’ve got a few tried-and-true fixes for you!

The root cause here is usually that PyInstaller doesn’t include the necessary macOS plist configuration to let your app respect the system’s appearance mode. Here’s how to fix it:

Option 1: Modify the PyInstaller Spec File (Most Reliable) #

First, generate a spec file if you haven’t already:

pyinstaller --windowed main.py --name MyApp --specpath .

Open the generated MyApp.spec file in a text editor, and find the app section. Add the InfoPlistDict key with the following setting:

app = BUNDLE(
    # ... existing code ...
    info_plist={
        'NSRequiresAquaSystemAppearance': False,
        'CFBundleDisplayName': 'Your App Name'  # Optional, but polishes macOS integration
    }
)

The NSRequiresAquaSystemAppearance flag set to False tells macOS your app should follow the system’s current light/dark mode instead of forcing light mode. Then re-package using the spec file:

pyinstaller MyApp.spec

Option 2: Add Code-Level Support for Theme Switching #

If you want extra insurance, add these lines right when you initialize your QApplication:

from PyQt5.QtWidgets import QApplication
from PyQt5.QtCore import Qt
import sys

if __name__ == "__main__":
    app = QApplication(sys.argv)
    # Enable high-DPI scaling (critical for Retina screens)
    app.setAttribute(Qt.AA_EnableHighDpiScaling)
    app.setAttribute(Qt.AA_UseHighDpiPixmaps)
    # Use Fusion style for better cross-platform theme compatibility
    app.setStyle("Fusion")
    
    # Rest of your app initialization code...
    main_window = YourMainWindow()
    main_window.show()
    sys.exit(app.exec_())

This is almost always related to missing Qt rendering libraries or incorrect high-DPI configuration. Let’s tackle this step by step:

Enable High-DPI Scaling (Mandatory for macOS) #

First, make sure you’ve added the two high-DPI attributes from the code above—Retina screens rely on these to render sharp text and graphics.

Force Antialiasing in Custom Widgets #

If you’re doing custom painting in any widgets, explicitly enable antialiasing and text antialiasing in your paintEvent:

from PyQt5.QtGui import QPainter

class CustomWidget(QWidget):
    def paintEvent(self, event):
        painter = QPainter(self)
        # Turn on antialiasing for smooth lines
        painter.setRenderHint(QPainter.Antialiasing)
        # Turn on text antialiasing for crisp text
        painter.setRenderHint(QPainter.TextAntialiasing)
        
        # Your painting code goes here...

Ensure PyInstaller Includes All Required Qt Libraries #

Sometimes PyInstaller misses critical Qt platform plugins or rendering resources. Update your spec file’s binaries and hiddenimports sections to include these:

import site
import os

qt_plugins_path = os.path.join(site.getsitepackages()[0], "PyQt5", "Qt", "plugins")

a = Analysis(
    # ... existing code ...
    hiddenimports=[
        'PyQt5.QtGui',
        'PyQt5.QtWidgets',
        'PyQt5.QtCore',
        'PyQt5.QtPrintSupport'  # Optional, but helps with consistent rendering
    ],
    binaries=[
        # Include the macOS Cocoa platform plugin
        (os.path.join(qt_plugins_path, "platforms", "libqcocoa.dylib"), "platforms")
    ],
)

This ensures the macOS-specific rendering plugin is included in the package, which fixes a lot of weird rendering glitches.

After applying these fixes, re-package your app with the updated spec file, and both issues should be resolved! Let me know if you hit any snags along the way.

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