Qt换肤本质是运行时动态切换QSS样式表，需调用unpolish()和polish()触发控件重解析样式，而非仅setStyleSheet()；须重写changeEvent响应StyleChange事件，统一广播更新，并注意状态栏、菜单栏、QDockWidget等特殊部件的单独处理。
Qt 换肤本质是动态切换 QSS 样式表
Qt 本身不提供“皮肤包”抽象层，所谓换肤就是运行时替换 QApplication::setStyleSheet() 的内容，并确保控件能响应样式变更。关键不是加载新文件，而是让已创建的控件重新解析并应用新样式——这需要主动触发 QWidget::style()->unpolish() 和 polish()，否则很多控件（如 QComboBox、QTabBar）看起来没变化。
必须重写 QWidget::changeEvent 处理 StyleHint 响应
仅调用 setStyleSheet() 不足以让所有控件实时更新。Qt 在系统主题或字体变化时会发送 QEvent::StyleChange 或 QEvent::PaletteChange，但自定义换肤需手动模拟这一流程。最稳妥的方式是在主窗口或基类中重写：
void MainWindow::changeEvent(QEvent *e) {
if (e->type() == QEvent::StyleChange) {
// 触发子控件重绘
qApp->sendEvent(this, new QEvent(QEvent::StyleChange));
// 或对关键控件显式 polish
ui->tabWidget->style()->unpolish(ui->tabWidget);
ui->tabWidget->style()->polish(ui->tabWidget);
}
QMainWindow::changeEvent(e);
}
- 不依赖
repaint()或update()：它们只刷新绘制，不重走样式计算逻辑 - 避免在每个控件上单独调用
polish()：性能差且易遗漏；优先用事件广播方式 - 若使用自定义
QProxyStyle，需确保其polish()支持增量更新，否则可能覆盖掉 QSS 设置的颜色
QSS 文件里慎用绝对路径和硬编码颜色
换肤失败常因样式表内部耦合了具体值。比如写 background: #2c3e50; 就锁死了深色主题，后续切肤只能靠字符串替换——脆弱且不可维护。推荐方案：
- 用 Qt 主题色角色替代固定值：
background: palette(window);、color: palette(text); - 把主题变量抽成独立
.qss片段（如colors-dark.qss），再用QFile::readAll()拼接主样式表 - 禁止在 QSS 中写
url(./icons/light/icon.svg)：路径相对 QApplication 当前工作目录，非可执行文件所在目录；应统一用QResource（:icons/light/icon.svg） - 字体设置优先用
font: system;而非font: 10pt "Segoe UI"，避免 Windows/macOS/Linux 渲染不一致
QMainWindow 的状态栏、菜单栏需单独处理
这些部件默认不继承主窗口的样式，尤其 QStatusBar 常被忽略。直接设 setStyleSheet() 到 statusBar() 有效，但更健壮的做法是：
- 在换肤函数中显式调用
statusBar()->setStyleSheet(qss) -
menuBar()下的QAction图标不会随 QSS 变化自动更新，需手动调用action->setIcon(QIcon(":/icons/dark/save.png")) - 若用了
QDockWidget，其标题栏样式由QDockWidget::title伪类控制，必须包含在主 QSS 中，不能靠父窗口继承
换肤真正难的不是加载新样式，而是识别哪些部件“假装更新了”——它们重绘了，但样式计算路径没走通。每次切肤后，盯着 QToolButton、QScrollBar::handle、QHeaderView 这几处看是否同步变色，比读文档更快定位问题。
