QPushButton圆角失效主因是未声明border属性，必须同时设置border（如transparent）和border-radius；hover无效多因未调用setFlat(true)或autoFillBackground干扰；高DPI下模糊需启用AA_UseHighDpiPixmaps。
QSS 设置 QPushButton 圆角失效的常见原因
直接写 border-radius 没反应？大概率是没同时设置 border。Qt 的 QSS 渲染机制要求：只要用了 border-radius，就必须显式声明 border（哪怕设为 none 或 transparent），否则圆角会被忽略。
- ✅ 正确写法：
border: 1px solid transparent; border-radius: 8px; - ❌ 错误写法：
border-radius: 8px;（无 border 声明） - ⚠️ 注意：
background-color必须设置，否则透明背景下圆角不可见；若用background-image，需确保图片本身支持裁剪（QSS 不会自动裁切）
QPushButton:hover 状态下样式不触发
悬停无效通常不是语法错，而是状态匹配失败。QPushButton 默认启用了 autoFillBackground 和平台样式干扰，导致 :hover 伪类被压制。
- 必须在代码中关闭系统风格接管：
button->setStyleSheet("..."); button->setFlat(true);（setFlat(true)能大幅提高 QSS 控制权） - :hover 只对鼠标真正进入控件区域生效；如果按钮有外边距（
margin）或父布局留白，悬停检测范围不会自动扩大 - 避免在样式中混用
background简写（如background: #fff url(x.png);），它可能覆盖background-color导致 hover 时颜色变化失效；建议拆成background-color+background-image
圆角 + 悬停 + 边框颜色渐变的一体化写法
想让按钮悬停时边框变色、背景微亮、保持圆角？关键在于状态叠加和属性隔离，避免互相覆盖。
QPushButton {
border: 2px solid #ccc;
border-radius: 6px;
background-color: #f8f8f8;
padding: 6px 12px;
}
QPushButton:hover {
border-color: #4a9eff;
background-color: #eef5ff;
}
QPushButton:pressed {
background-color: #d0e4ff;
padding-top: 7px;
padding-bottom: 5px;
}
-
border-color单独改比重写整个border更安全，防止border-radius失效 -
:pressed状态里调整padding可模拟“按下去”的视觉反馈，但注意别让文字位置抖动过大 - 如果用了
qlineargradient作背景，务必加border: none;，否则渐变会被边框截断
高 DPI 屏幕下圆角模糊或锯齿问题
在 2K/4K 屏上，QSS 渲染的圆角边缘发虚？这不是 bug，是 Qt 默认用整数像素绘制，而高 DPI 下物理像素密度翻倍，导致抗锯齿采样不足。
立即学习“C++免费学习笔记（深入）”；
- 强制启用高质量渲染：在 QApplication 初始化后加
QApplication::setAttribute(Qt::AA_UseHighDpiPixmaps); - 圆角值尽量用偶数（如
8px而非7.5px），避免 sub-pixel 渲染异常 - 如果仍模糊，可临时绕过 QSS，用
QPainter在paintEvent中手绘圆角背景（仅限极端要求场景）
圆角和悬停看着简单，但实际卡点全在 border 声明、flat 属性、状态优先级这三处；漏掉任意一个，样式就“看起来写了，却没反应”。
