Qt 6/macOS菜单栏附着窗口 如何移至屏幕顶部原生系统菜单栏

问题原因 #

Qt 6 对 Qt Quick Controls 的菜单栏默认逻辑做了不兼容变更：Qt 5.15 默认会把ApplicationWindow下的MenuBar自动挂载到macOS顶部系统原生菜单栏，Qt 6 开始这个特性默认关闭，菜单栏默认作为窗口内部控件渲染，就会出现在窗口上边缘。

修复方法 #

按以下顺序检查配置即可：

• 检查C++入口配置
  打开项目的main.cpp，确认没有手动禁用原生菜单栏的代码，存在的话直接删除：

  // 这行代码会强制禁用原生菜单栏，必须删除
  QCoreApplication::setAttribute(Qt::AA_DontUseNativeMenuBar);
  

  如果需要显式声明启用，可以在创建QGuiApplication实例前加入：

  QCoreApplication::setAttribute(Qt::AA_DontUseNativeMenuBar, false);
  

• QML侧开启原生菜单栏开关
  Qt 6 的MenuBar新增了nativeMenuBar属性，默认值为false，手动设置为true即可让菜单显示到系统顶部栏。修改后的完整QML代码：

  ApplicationWindow {
      id: window
      width: 320
      height: 260
      visible: true
  
      menuBar: MenuBar {
          nativeMenuBar: true // *核心配置*：启用原生菜单栏渲染
          Menu {
              title: qsTr("&File")
              Action { text: qsTr("&New...") }
              Action { text: qsTr("&Open...") }
              Action { text: qsTr("&Save") }
              Action { text: qsTr("Save &As...") }
              MenuSeparator { }
              Action { text: qsTr("&Quit") }
          }
          Menu {
              title: qsTr("&Edit")
              Action { text: qsTr("Cu&t") }
              Action { text: qsTr("&Copy") }
              Action { text: qsTr("&Paste") }
          }
          Menu {
              title: qsTr("&Help")
              Action { text: qsTr("&About") }
          }
      }
  }
  

常见踩坑点 #

• 多版本兼容：如果代码需要同时适配Qt5和Qt6，可以用版本判断避免Qt5下报未知属性错误：

  nativeMenuBar: Qt.version >= Qt.qtVersion(6,0,0)
  

• 缓存问题：修改后如果不生效，先清空项目构建目录的QML缓存再重新编译，Qt的QML缓存经常会导致属性修改不生效。
• 系统菜单合并：macOS会自动把「About」「Quit」这类标准菜单项合并到左上角苹果图标旁的应用菜单下，属于系统默认行为，不是代码问题。

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