Qt QML窗口在macOS下闪烁问题排查求助

针对切换应用后返回Qt程序出现的窗口闪烁问题（Windows下无此异常），可以尝试以下几种解决方法：

• 调整窗口属性
  给窗口添加特定属性，禁用可能导致闪烁的系统背景处理：

  yourWindow->setAttribute(Qt::WA_NoSystemBackground);
  yourWindow->setAttribute(Qt::WA_OpaquePaintEvent);
  // 若使用半透明背景则跳过WA_NoSystemBackground，仅设置WA_OpaquePaintEvent
  

  同时可以尝试禁用macOS的透明效果相关属性：

  yourWindow->setAttribute(Qt::WA_MacShowFocusRect, false);
  

• 切换渲染后端
  Qt在macOS默认使用Metal渲染后端，部分场景下可能存在兼容性问题，切换为OpenGL后端试试：

  // 针对QQuickWindow（Qt Quick程序）
  QQuickWindow::setSceneGraphBackend(QSGRendererInterface::OpenGL);
  // 针对Widget程序，强制使用软件渲染或OpenGL
  QApplication::setAttribute(Qt::AA_UseSoftwareOpenGL);
  

  也可以通过环境变量临时测试：在启动程序前设置QT_QUICK_BACKEND=opengl（Qt Quick）或QT_OPENGL=software（Widget）。

• 强制窗口重绘
  重写窗口的激活事件，在窗口切换回前台时强制刷新：

  void YourMainWindow::windowActivationChange(bool active) {
      QMainWindow::windowActivationChange(active);
      if (active) {
          this->repaint();
          // 若存在自定义控件，也需触发其重绘
          ui->customWidget->repaint();
      }
  }
  

• 优化重绘逻辑
  检查自定义控件的paintEvent实现，避免在绘制过程中执行耗时操作；批量更新UI时，先调用setUpdatesEnabled(false)，完成后再开启：

  this->setUpdatesEnabled(false);
  // 执行批量UI更新操作
  ui->label->setText("更新内容");
  ui->listWidget->addItems(items);
  this->setUpdatesEnabled(true);
  this->repaint();
  

• 升级Qt版本
  该闪烁问题可能是Qt特定版本与macOS系统的兼容性bug，建议升级到最新的Qt LTS版本（如5.15.12+或6.5+），多数官方已知的窗口渲染bug会在新版本中修复。

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