PAYATHON 2026

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 跟踪确认。

另外两个低成本排查

  1. 把 setCheckState 放到 addItem 之后,排除 item 尚未挂到 view 上时的状态刷新问题:
item = QListWidgetItem(f'Item {i + 1}')
item.setFlags(item.flags() | Qt.ItemIsUserCheckable)
list_widget.addItem(item)
item.setCheckState(Qt.Checked)
  1. 在 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。

备注:内容仅供参考。