QSS是Qt样式系统中直接管控件绘制逻辑的规则层，需通过QApplication::setStyleSheet()全局加载，QPushButton:hover等伪状态失效常因底层QStyle不支持或父子控件干扰，圆角阴影等效果依赖background、border、padding协同，动态换肤应优先使用setProperty驱动QSS属性匹配而非重复reload样式表。
QSS不是“加点颜色就完事”的辅助手段，它是Qt样式系统里真正接管控件绘制逻辑的规则层——写对了，按钮悬停变色、输入框聚焦高亮、复选框勾选动画全都不用写一行C++；写错了，setStyleSheet调了十遍，QPushButton:hover照样不生效。
全局样式加载必须走 QApplication::setStyleSheet()，别在 QMainWindow 里硬塞
很多人想“先试试效果”，随手在主窗口构造函数里写：ui->centralWidget->setStyleSheet("...")，结果发现菜单栏、状态栏、工具栏全没反应。这是因为这些部件不是 centralWidget 的子控件，它们由 QApplication 直接管理。只有通过 QApplication::setStyleSheet() 才能覆盖整个应用上下文。
- 正确做法：在
main()函数中，QApplication a(argc, argv);之后立即调用a.setStyleSheet(...)或a.setStyleSheet(FileUtil::readFile(":/styles/dark.qss")) - 错误惯性：在某个 QWidget 子类里调
setStyleSheet，只影响该 widget 及其直接子控件（且受继承性限制），对 QMenuBar、QStatusBar 这类顶层部件完全无效 - 注意路径：用
:/前缀加载资源文件时，确保 .qss 已声明进.qrc，否则readFile返回空字符串，样式静默失效
QPushButton:hover 不触发？检查伪状态是否被父控件或平台 style 拦截
写了 QPushButton:hover { background: red; } 却没反应，大概率不是语法错，而是 Qt 的样式链出了问题。QSS 并非直接画图，它作为一层代理 style（QStyleSheetStyle）包裹在原生 style（比如 QFusionStyle）外面，一旦底层 style 拒绝把 hover 事件透出，QSS 就收不到信号。
- 必做验证：先临时设成
QApplication::setStyle("Fusion")，Fusion 是 Qt 唯一明确支持完整伪状态的内置 style；Windows/macOS 默认 style 对:hover、:pressed支持极弱 - 父子干扰：如果 QPushButton 在 QGroupBox 里，而 QGroupBox 本身有
background-color，可能遮盖按钮 hover 区域——加border: none;或outline: none;排查 - 焦点前提：某些平台下
:hover仅在控件可 focus 时才激活，给按钮加setFocusPolicy(Qt::StrongFocus)再试
圆角、阴影、渐变这些“高级效果”得靠盒模型 + 属性组合，单靠 border-radius 不够
border-radius: 8px; 只是起点。真正让按钮看起来“有厚度”“可点击”，需要三者配合：背景填充方式、边框行为、内边距留白。漏掉任意一项，UI 就会发虚或塌陷。
- 圆角生效前提：必须同时设置
background（纯色/渐变）和border: none;；如果用了border: 1px solid #ccc;，圆角会被边框硬切掉 - 阴影要真生效：Qt 不支持
box-shadow，得用qlineargradient模拟，或者靠QGraphicsDropShadowEffect手动挂载（但注意性能，别给每行表格项都加） - 渐变写法陷阱：不要写
background: linear-gradient(...)—— Qt 只认qlineargradient或qradialgradient；正确示例：background: qlineargradient(x1:0, y1:0, x2:1, y2:1, stop:0 #4A90E2, stop:1 #6A5ACD);
换肤时别直接 reload setStyleSheet，用属性驱动 + QObject::setProperty 更稳
动态切换深色/浅色主题时，反复调 QApplication::setStyleSheet() 看似简单，实则埋雷：QSS 解析开销大、旧样式残留导致闪烁、子控件状态错乱（比如 QComboBox 下拉箭头颜色没更新）。工程级换肤应该让样式表本身“活”起来。
- 核心技巧：在 .qss 里用
??占位符，例如QPushButton { background: @primaryColor; }，再通过qApp->setStyleSheet(qssText.arg(primaryColor))注入值 - 更推荐方案：用
QObject::setProperty("theme", "dark")设主题标识，QSS 中写QPushButton[theme="dark"] { color: white; }，Qt 会自动监听 property 变化并重绘 - 致命坑：别在换肤时 delete 所有 widget 再重建——QSS 绑定的是对象实例，重建后所有
setStyleSheet调用都得重做，且信号槽连接易丢失
最常被忽略的一点：QSS 的选择器优先级和 CSS 不完全一致，QPushButton#myBtn（ID选择器）不一定比 QWidget QPushButton（后代选择器）优先级高；真遇到样式不生效，别急着改代码，先用 Qt Creator 的 Ctrl+R 实时预览，再打开 qApp->setStyleSheet("... * { border: 1px solid red; }") 强制描边，看实际匹配范围在哪——很多时候你以为自己在改按钮，其实样式早被某个父容器的 QFrame 全局规则吞掉了。
