PyQt5中QStyledItemDelegate无法像PyQt4正常工作的问题排查

PyQt4与PyQt5中model.data()的返回值差异 #

在PyQt4中，QAbstractItemModel.data()始终返回QVariant对象——即使指定角色没有对应数据，也会返回一个无效的QVariant。此时调用toInt()是合法的，它会返回(转换后的值, 是否转换成功)的元组，不会抛出错误。

而PyQt5彻底移除了QVariant，model.data()直接返回原生Python类型（如int、str）。如果指定角色没有对应数据，该方法会返回None。对None调用toInt()自然会触发AttributeError: 'NoneType' object has no attribute 'toInt'。

针对这个问题，你需要修改代码适配PyQt5的返回逻辑，具体步骤如下：

1. 先检查数据是否为None #

在尝试转换或使用数据前，先判断返回值是否为None，避免直接调用方法：

raw_data = index.model().data(index, Qt.UserRole)
if raw_data is not None:
    # 处理有效数据
else:
    # 处理无数据场景，比如设置默认值

2. 替换toInt()为原生Python类型转换 #

PyQt5返回原生类型，若数据应为整数，直接用int()转换即可，还可以模拟PyQt4中toInt()的返回逻辑（值+转换成功标志）：

raw_data = index.model().data(index, Qt.UserRole)
data = 0
ok = False

if raw_data is not None:
    try:
        data = int(raw_data)
        ok = True
    except (ValueError, TypeError):
        # 转换失败时保持默认值
        pass
# 后续使用data和ok变量

3. 确认模型是否正确设置了Qt.UserRole的数据 #

如果raw_data始终为None，需要检查你的模型类（继承自QAbstractItemModel或其子类）的data()方法是否正确处理了Qt.UserRole，确保该角色下返回有效整数值：

def data(self, index, role=Qt.DisplayRole):
    if role == Qt.UserRole:
        # 返回对应整数数据
        return self.some_data[index.row()]
    # 其他角色的处理逻辑
    ...

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