PyQt6开发MacOS应用：深色模式下如何设置黑色菜单栏？

云上老周

2026-8-11

在MacOS深色模式下让PyQt6应用显示黑色菜单栏

首先明确：MacOS的Finder菜单栏在深色模式下确实不会变黑，这是系统默认行为；而Chrome这类应用是通过调用原生Cocoa API强制启用了深色菜单栏效果。要在PyQt6中实现同样效果，需要借助PyObjC调用MacOS原生接口，步骤如下：

安装依赖：首先需要安装PyObjC，它能让Python调用Cocoa框架：
```
pip install pyobjc-core pyobjc-framework-Cocoa
```

修改应用初始化代码：在QApplication初始化后，添加原生代码设置菜单栏外观：

import sys
from PyQt6.QtWidgets import QApplication, QMainWindow
from Cocoa import NSApplication, NSAppearance, NSAppearanceNameDarkAqua

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("深色菜单栏示例")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    
    # 获取MacOS原生应用实例，设置深色菜单栏
    ns_app = NSApplication.sharedApplication()
    dark_appearance = NSAppearance.appearanceNamed_(NSAppearanceNameDarkAqua)
    ns_app.setAppearance_(dark_appearance)
    
    window = MainWindow()
    window.show()
    sys.exit(app.exec())

这段代码会强制应用激活时的全局菜单栏使用深色外观，无论系统当前是深色还是浅色模式。如果想让菜单栏跟随系统模式自动切换，可以监听系统外观变化事件，再动态切换外观。

PyInstaller打包注意事项：打包时需要确保PyObjC的相关库被正确包含，否则运行时会报错。可以通过以下方式处理：
1. 创建spec文件时，添加hidden imports：
```
hiddenimports=['Cocoa', 'objc']
```
2. 或者直接用命令行打包：
```
pyinstaller --hidden-import Cocoa --hidden-import objc your_app.py
```