Qt 5.11迁移问题：UI元素需点击才会刷新

这个问题我之前帮团队迁移Qt4项目到Qt5时碰到过一模一样的情况，Qt5在macOS平台的视图刷新逻辑和Qt4确实有不少细节差异，尤其是移除QtDeclarative后，一些隐式的刷新触发机制没了。下面给你几个实测有效的解决方向：

• 显式触发视图单元格/区域刷新
  Qt4里很多时候修改widget内容后框架会自动帮你触发重绘，但Qt5为了优化性能，把部分自动刷新的逻辑改成了需要显式调用。比如修改QTableWidget的某个item后，直接调用对应单元格的刷新方法：

  // 修改item内容
  ui->tableWidget->item(row, col)->setText("更新后的内容");
  // 显式刷新该单元格
  ui->tableWidget->updateCell(row, col);
  

  如果是批量修改了多个内容，不想逐个调用updateCell，可以直接刷新整个视图区域：

  ui->tableWidget->viewport()->update();
  

  QTreeWidget的话类似，修改item后可以调用ui->treeWidget->viewport()->update()，或者针对特定item调用ui->treeWidget->update(item)。

• 禁用macOS自动Layer渲染
  Qt5在macOS上默认会给一些widget启用Core Animation Layer来优化渲染，但有时候这种layer机制会导致视图刷新延迟，尤其是在非焦点状态下。你可以在widget的构造函数里禁用自动layer：

  // 针对QTableWidget或QTreeWidget设置
  ui->tableWidget->setAttribute(Qt::WA_MacNoAutoLayer, true);
  

  这个设置会强制widget使用传统的重绘逻辑，很多时候能解决点击才刷新的问题。

• 批量修改时阻塞信号+统一刷新
  如果是一次性修改大量数据（比如循环添加几百个item），Qt4会自动合并刷新操作，但Qt5可能会因为频繁的信号发射导致刷新混乱。可以先阻塞widget的信号，修改完成后再解除阻塞并统一刷新：

  ui->tableWidget->blockSignals(true);
  // 这里执行批量修改操作，比如循环添加item或修改内容
  for (int i = 0; i < 100; ++i) {
      ui->tableWidget->setItem(i, 0, new QTableWidgetItem(QString::number(i)));
  }
  ui->tableWidget->blockSignals(false);
  // 统一刷新整个视图
  ui->tableWidget->viewport()->update();
  

• 检查事件循环是否被阻塞
  有时候如果你的修改操作是在一个长时间运行的同步函数里，事件循环被阻塞了，视图没法及时处理刷新事件。这种情况下可以在修改完成后手动触发一次事件循环处理：

  // 修改内容后调用
  QApplication::processEvents(QEventLoop::ExcludeUserInputEvents);
  

  注意尽量不要滥用这个方法，只有当确实存在事件循环阻塞的情况才用，否则可能影响其他UI交互。

你可以先从第一个方法开始试，大部分情况下显式调用刷新就能解决问题，如果还是不行再尝试后面的方案。

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