PySide6中如何为数据表布尔列添加可编辑复选框？

你其实没用到PySide6内置的便捷机制，不需要大量自定义代码就能实现需求：

方案一：用QSqlTableModel直接绑定数据库（推荐） #

如果你的数据来自数据库，QSqlTableModel会自动识别布尔类型字段，配合QTableView就能直接生成可点击切换的复选框，无需额外自定义Delegate：

from PySide6.QtWidgets import QApplication, QTableView
from PySide6.QtSql import QSqlDatabase, QSqlTableModel

app = QApplication([])

# 连接数据库（以SQLite为例）
db = QSqlDatabase.addDatabase("QSQLITE")
db.setDatabaseName("test.db")
db.open()

# 绑定数据表
model = QSqlTableModel()
model.setTable("your_table")
model.setEditStrategy(QSqlTableModel.OnFieldChange)  # 字段修改后立即同步数据库
model.select()

# 配置视图
view = QTableView()
view.setModel(model)
view.setEditTriggers(QTableView.DoubleClicked | QTableView.SelectedClicked)  # 允许点击编辑
view.show()

app.exec()

只要你的数据库字段是布尔类型，对应列会自动渲染为可点击的复选框，点击后直接同步到数据库，代码量极少。

方案二：自定义模型用QStandardItem #

如果是处理非数据库的自定义数据，用QStandardItemModel时，给布尔字段对应的QStandardItem设置setCheckable(True)即可：

from PySide6.QtWidgets import QApplication, QTableView, QStandardItemModel, QStandardItem

app = QApplication([])

model = QStandardItemModel(3, 2)
model.setHorizontalHeaderLabels(["名称", "状态"])

# 添加数据，布尔列设置复选框
for row in range(3):
    name_item = QStandardItem(f"项目{row+1}")
    status_item = QStandardItem()
    status_item.setCheckable(True)
    status_item.setCheckState(row % 2)  # 初始状态交替
    model.setItem(row, 0, name_item)
    model.setItem(row, 1, status_item)

view = QTableView()
view.setModel(model)
view.show()

app.exec()

点击复选框会自动更新item的状态，你可以通过item.checkState()获取当前值。

其他框架对比 #

Tkinter实现 #

Tkinter的ttk.Treeview本身不支持原生复选框，需要手动绑定事件并绘制复选框，或依赖第三方组件嵌入单元格，代码复杂度和PySide6原生方案相当，甚至更繁琐——因为要自己处理点击事件与状态同步逻辑。

wxPython实现 #

wxPython的wx.grid.Grid可以通过SetCellEditor和SetCellRenderer给布尔列配置专属编辑器与渲染器，代码量和PySide6自定义模型方案差不多：

import wx
import wx.grid

class MyFrame(wx.Frame):
    def __init__(self):
        super().__init__(None, title="wxPython布尔列示例")
        grid = wx.grid.Grid(self)
        grid.CreateGrid(3, 2)
        grid.SetColLabelValue(0, "名称")
        grid.SetColLabelValue(1, "状态")
        
        # 配置布尔列
        grid.SetCellEditor(1, 0, wx.grid.GridCellBoolEditor())
        grid.SetCellRenderer(1, 0, wx.grid.GridCellBoolRenderer())
        for row in range(3):
            grid.SetCellValue(row, 0, f"项目{row+1}")
            grid.SetCellValue(row, 1, "1" if row%2 else "0")
        
        self.Show()

app = wx.App()
frame = MyFrame()
app.MainLoop()

但wxPython的数据库绑定便捷性不如PySide6的QSqlTableModel，如果你核心需求是操作数据库，PySide6的原生方案依然更高效。

内容的提问来源于stack exchange，提问作者Adam Jacobs