使用Mac OS High Sierra SDK构建Qt应用后窗口最小化功能失效

你遇到的是Qt 5.9/5.10在MacOS 10.13 SDK下的典型兼容性bug——当窗口设置了Qt::FramelessWindowHint后，Qt内置的showMinimized()和setWindowState(Qt::WindowMinimized)方法无法正确和系统窗口服务交互，导致最小化操作失效，但在10.12 SDK下能正常工作。我之前处理过类似问题，给你几个可行的解决方案：

方案1：调用Mac原生API触发最小化 #

这是最可靠的解决方式，绕过Qt的封装直接调用系统原生窗口API执行最小化：

首先需要开启项目的Objective-C++支持：

• 把对应的源文件后缀改成.mm（比如mainwindow.cpp改为mainwindow.mm）
• 或者在.pro文件中添加：QMAKE_CXXFLAGS += -x objective-c++

然后替换默认的最小化逻辑：

#include <QMacNativeWidget>
#include <objc/objc.h>
#include <objc/message.h>

// 自定义最小化槽函数
void MainWindow::triggerMinimize()
{
    // 获取Qt窗口对应的原生NSWindow指针
    NSWindow *nativeWin = reinterpret_cast<NSWindow*>(QMacNativeWidget::nativeWindowHandle(this));
    if (nativeWin) {
        // 调用Mac系统的miniaturize方法完成最小化
        objc_msgSend(nativeWin, sel_getUid("miniaturize:"), nullptr);
    }
}

// 构造函数中修改按钮连接
MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) {
    setWindowFlags(Qt::Window | Qt::FramelessWindowHint);
    QPushButton* minimizeButton = new QPushButton(this);
    minimizeButton->setText(QLatin1String("Minimize"));
    // 连接到自定义槽，替代默认的showMinimized
    connect(minimizeButton, &QPushButton::clicked, this, &MainWindow::triggerMinimize);
}

方案2：调整窗口标志组合 #

尝试在无边框标志基础上添加Qt::WindowSystemMenuHint，让系统识别窗口的最小化能力：

setWindowFlags(Qt::Window | Qt::FramelessWindowHint | Qt::WindowSystemMenuHint);

之后再调用showMinimized()，部分场景下这个方法可以生效，但稳定性不如方案1。

方案3：升级Qt版本（推荐） #

这个bug在Qt 5.12及以后的版本中已经被官方修复，如果你项目允许，升级到Qt 5.12+不仅能解决这个问题，还能获得更好的MacOS新特性支持。

方案4：临时降级SDK #

如果以上方案暂时无法实施，你可以继续使用10.12 SDK编译项目，这样原有逻辑就能正常工作，但这只是过渡方案，长期建议适配新SDK。

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