macOS 27 升级后 PySide6 QListWidget 勾选框缺失
数据小陈
你贴出的代码没有明显缺项。正常情况下,给每个 QListWidgetItem 设置 Qt.ItemIsUserCheckable 并调用 setCheckState(Qt.Checked) 后,QListWidget 中每一项都应该显示勾选框。在 macOS 27 + PySide6 6.11.2 下只显示第一项,更像是 macOS 原生样式或 item delegate 绘制相关的兼容性回归;漏写 API 的可能性不大。但仅凭这段描述还不能直接断定是官方已知 bug,需要先用最小复现和切换样式确认。
最小复现
把缩进补全,并用 sys.argv 初始化 QApplication:
import sys
from PySide6.QtWidgets import QApplication, QListWidget, QListWidgetItem
from PySide6.QtCore import Qt
app = QApplication(sys.argv)
list_widget = QListWidget()
for i in range(5):
item = QListWidgetItem(f'Item {i + 1}')
item.setFlags(item.flags() | Qt.ItemIsUserCheckable)
item.setCheckState(Qt.Checked)
list_widget.addItem(item)
list_widget.show()
sys.exit(app.exec())
如果这个版本仍然只有第一项有勾选框,基本可以排除 for 循环、flags 和 checkState 的调用顺序问题。
换成 Fusion 样式确认
在创建控件前切换样式:
import sys
from PySide6.QtWidgets import QApplication, QListWidget, QListWidgetItem
from PySide6.QtCore import Qt
app = QApplication(sys.argv)
app.setStyle('Fusion')
list_widget = QListWidget()
for i in range(5):
item = QListWidgetItem(f'Item {i + 1}')
item.setFlags(item.flags() | Qt.ItemIsUserCheckable)
item.setCheckState(Qt.Checked)
list_widget.addItem(item)
list_widget.show()
sys.exit(app.exec())
如果 Fusion 下所有项都正常显示勾选框,而 macOS 原生样式下只显示第一项,那么问题大概率出在 macOS 27 的原生 style 与 Qt/PySide6 的 QListWidget 勾选框绘制路径上。此时可以临时改用 Fusion,同时准备最小复现,到 Qt Bug Tracker 或 PySide6 issue 跟踪确认。
另外两个低成本排查
- 把 setCheckState 放到 addItem 之后,排除 item 尚未挂到 view 上时的状态刷新问题:
item = QListWidgetItem(f'Item {i + 1}')
item.setFlags(item.flags() | Qt.ItemIsUserCheckable)
list_widget.addItem(item)
item.setCheckState(Qt.Checked)
- 在 show 之后刷新 viewport:
list_widget.show()
list_widget.viewport().update()
这两步不是根因修复,只用于判断是不是状态同步或绘制缓存问题。
注意事项
- 如果业务必须使用 macOS 原生外观,不要长期依赖 viewport().update() 这类刷新手段;优先确认 Qt/PySide6 的新版本是否修复,或临时使用 Fusion。
- 提交问题时保留 macOS 27、Python 3.14.0、PySide6 6.11.2、最小代码、实际截图和“macOS 26 正常、macOS 27 异常”的对比信息。
- 在未确认官方 issue 前,建议表述为“疑似 macOS 27 原生样式兼容性回归”,不要直接写成已确认的 Qt bug。
备注:内容仅供参考。
