PyQt6 中 QPushButton 的 :hover 伪状态常无法正确触发背景色变化，这是 Qt 6.5+ 在 Windows 11 默认样式下的已知渲染缺陷（QTBUG-134497）；本文提供两种稳定可靠的修复方案：添加边框或切换为 Fusion 样式。
pyqt6 中 qpushbutton 的 `:hover` 伪状态常无法正确触发背景色变化，这是 qt 6.5+ 在 windows 11 默认样式下的已知渲染缺陷（qtbug-134497）；本文提供两种稳定可靠的修复方案：添加边框或切换为 fusion 样式。
在 PyQt6 中使用 QSS（Qt Style Sheets）自定义 QPushButton 的悬停效果时，开发者常遇到一个典型问题：:hover 状态下文字颜色能正常响应，但 background-color 却无变化——除非显式声明 border 属性。这一行为并非代码错误，而是 Qt 6.5 及以上版本在 Windows 11 原生样式（如 WindowsVista 或 Windows）中对无边框按钮的渲染优化所导致的副作用（QTBUG-134497）。该问题在 PyQt5 中不存在，但在 PyQt6 中广泛影响 Windows 用户。
✅ 推荐解决方案一：启用 Fusion 样式（推荐首选）
Fusion 是 Qt 官方提供的跨平台、纯绘制风格，专为样式表（QSS）深度优化设计。它不依赖系统原生控件，因此能确保 :hover、:pressed 等伪状态完全按 CSS 规则执行：
from PyQt6.QtWidgets import QApplication, QMainWindow, QPushButton
from PyQt6.QtCore import QSize, QPoint
class AppWindow(QMainWindow):
def __init__(self):
super().__init__()
self.setWindowTitle('METAR Tool')
self.setFixedSize(QSize(500, 300))
self.button = QPushButton(parent=self, text='Fetch METAR')
self.button.setStyleSheet("""
QPushButton {
color: white;
background-color: #42baff;
border: none;
border-radius: 6px;
padding: 12px;
}
QPushButton:hover {
background-color: #3ca8e6;
}
QPushButton:pressed {
background-color: #2a95d1;
}
""")
self.button.setFixedSize(QSize(400, 60))
self.button.move(QPoint(50, 220))
class AppCore():
def __init__(self):
self.app = QApplication([])
self.app.setStyle("Fusion") # ? 关键：全局启用 Fusion 样式
self.window = AppWindow()
self.window.show()
def run(self):
self.app.exec()
AppCore().run()
✅ 优势：语义清晰、无需冗余边框、支持完整伪状态链（
hover/pressed/disabled）、跨平台一致。
⚠️ 注意：setStyle("Fusion")必须在创建任何窗口前调用，且仅需一次。
✅ 推荐解决方案二：添加透明/同色边框（兼容性兜底）
若因设计约束必须保留系统样式，可通过添加极细、视觉不可见的边框“唤醒” hover 渲染引擎：
self.button.setStyleSheet("""
QPushButton {
color: white;
background-color: #42baff;
border: 1px solid #42baff; /* ? 关键：即使颜色相同也需声明 */
border-radius: 6px;
}
QPushButton:hover {
background-color: #3ca8e6;
border: 1px solid #3ca8e6; /* 边框颜色同步更新 */
}
""")
此方法本质是绕过 Qt 渲染器的优化判断逻辑——当检测到 border 属性存在时，会启用完整的样式重绘流程。即使边框宽度为 0.5px 或颜色与背景一致，也能生效。
? 总结与最佳实践
-
优先使用
app.setStyle("Fusion")：这是最干净、可维护性最强的方案，尤其适合需要统一 UI 风格的桌面应用； -
避免仅依赖
:hover+background-color而无border：在 PyQt6 + Windows 系统下属于未定义行为； -
补充
:pressed和border-radius：提升交互反馈与现代感（如上例所示）； - 测试多平台：Fusion 在 Linux/macOS 下表现一致；若坚持系统样式，务必在目标平台验证 hover 行为。
通过上述任一方式，即可彻底解决 PyQt6 中 QPushButton 悬停背景色失效问题，确保 UI 交互逻辑符合设计预期。
