Qt QSS 不是 CSS，项目里最容易栽在这几个细节上
设计稿一来，QSS 最先背锅
很多 Qt 项目一开始都觉得样式表很香。设计稿给了按钮颜色、圆角、边框，几行 QSS 下去，界面马上从“默认控件风”变得像个产品。尤其是桌面客户端、工业上位机、配置工具这类项目，客户第一眼看的不是线程模型，也不是数据库封装，而是界面像不像那么回事。
问题是，QSS 看着像 CSS，但它真不是浏览器里的 CSS。demo 里改个 QPushButton 很顺，到了项目里，QComboBox 下拉箭头不听话，QHeaderView 边框对不齐，QTableView 选中状态颜色和 hover 状态打架，Windows 正常，Linux 上又变样。最后你会发现，QSS 最大的坑不是“不会写”，而是以为它和 CSS 一样可控。
它解决的是外观，不是 UI 架构
QSS 的本质，是 Qt 在 QWidget 样式系统上加的一层规则匹配。它通过对象类型、对象名、属性、伪状态、子控件去命中控件，然后交给样式引擎绘制。比如项目里常见写法：
ui->btnDelete->setProperty("role","danger");ui->btnDelete->style()->unpolish(ui->btnDelete);ui->btnDelete->style()->polish(ui->btnDelete);这段代码解决的是一个很实际的问题：运行时根据业务状态切换按钮样式。比如设备离线后，“断开连接”按钮变灰；数据异常时，“删除记录”按钮变红。动态属性改了之后，不主动 repolish，很多控件不会立刻刷新样式，这就是典型的 demo 不明显、项目里很烦人的细节。
对应的 QSS 可能是这样：
QPushButton[role="danger"]{background:#d9534f;color:white;}QPushButton[role="danger"]:disabled{background:#999999;}这类写法比到处setStyleSheet()拼字符串靠谱。原因很简单：样式应该集中管理，业务代码只负责表达状态。否则项目做大后，按钮红色到底在哪一层被改掉，你会查到怀疑人生。
子控件才是 QSS 最容易翻车的地方
普通按钮还好，一到复合控件，QSS 就开始露出脾气。QComboBox、QScrollBar、QSlider、QSpinBox、QTabBar 这些控件都有子控件。你只写外层，很多细节根本不会变。
比如：
QComboBox::drop-down{width:28px;border-left:1px solid #cccccc;}QComboBox::down-arrow{image:url(:/icons/arrow_down.png);}这不是为了炫技，而是项目里真会遇到：设计稿要求下拉框箭头区域固定宽度，默认平台样式又不符合视觉规范。QSS 里::处理的是子控件，:hover、:checked、:disabled处理的是状态，这两个概念混了，样式就会看起来“没生效”。
更麻烦的是平台差异。Qt 在不同系统上底层 style 不完全一样，同一份 QSS 在 Windows、Ubuntu、国产系统上可能有细节偏差。工业项目里经常开发机是 Windows，现场机是 Linux，一上线才发现表格行高、滚动条宽度、字体渲染都不一样。这个时候别急着怀疑 Qt，先接受一个现实：QSS 能统一大部分外观，但很难保证像浏览器 CSS 那样精确一致。
项目里我一般这么处理
我的习惯是把 QSS 分层：全局基础样式一份，模块样式一份，特殊控件少量单独处理。比如主窗口加载主题文件，业务页面不要随便setStyleSheet()覆盖父级样式。对象名只用于少数明确的定制控件，不拿它当万能选择器。
最怕的是这种写法：
ui->widget->setStyleSheet("QPushButton{background:red;}");这行代码短期很快，后期很毒。它可能影响当前 widget 下所有 QPushButton，哪天页面里加了一个“取消”按钮，也跟着变红。QSS 的作用域不清楚，本质上就是 UI 层的隐形债务。
常见坑或经验提醒
第一，别把 QSS 当完整 CSS 用。很多属性不支持，盒模型也没那么自由。第二，动态属性变更后记得刷新样式。第三，子控件必须单独写，不要指望外层规则自动覆盖所有细节。第四，少在业务逻辑里拼 QSS 字符串，维护成本会越来越高。第五，复杂控件如果 QSS 改到很痛苦，就别硬改了，直接自定义 delegate 或重写 paintEvent 反而更稳。
最后说两句，QSS 适合做项目级视觉统一，不适合承担复杂 UI 行为设计。它能让 Qt 程序快速接近设计稿，但不能替你解决控件结构、状态管理和跨平台差异。真正稳的做法，是把 QSS 当成一层皮肤系统：规则集中、状态清晰、边界克制。界面越复杂，越要少写“临时能用”的样式。因为这些临时样式，最后通常都会变成你不敢删的历史包袱。