移植PyQt5代码到PySide2时遭遇TypeError：常量属性不可包含WRITE方法或NOTIFY信号

问题背景 #

我正在把一段可正常运行的PyQt5代码移植到PySide2环境中，编写了一个暴露给QML引擎的只读数据类，但运行时触发了错误。

我的代码片段：

import sys
from PySide2.QtCore import Property, QObject
from PySide2.QtGui import QGuiApplication

class DataPoint(QObject):
    def __init__(self, timestamp=0, high=0, low=0, parent=None):
        super().__init__(parent)
        self._timestamp = timestamp
        self._high = high
        self._low = low

    @Property(float, constant=True)
    def timestamp(self):
        return self._timestamp
# 省略high和low的Property定义

运行时触发的错误：

Traceback (most recent call last):
  line 14, in <module>
    class DataPoint(QObject):
  line 22, in DataPoint
    def timestamp(self):
TypeError: A constant property cannot have a WRITE method or a NOTIFY signal.

错误原因 #

这个问题的核心是PyQt5和PySide2对constant=True参数的语义定义完全不同：

• 在PyQt5中，constant=True用于标记实例级别的只读属性——意思是该属性的值在实例生命周期内不会改变，允许getter方法通过self访问实例的私有变量。
• 但在PySide2中，constant=True的含义是类级别的常量——所有实例的这个属性值完全相同，对应的getter方法不能依赖实例（也就是不能接收self参数），因为它本质上是一个类共享的值。

你的代码中，getter方法带self，试图返回实例独有的_timestamp，这和PySide2对constant属性的要求冲突，所以触发了这个TypeError（虽然错误提示提到了WRITE/NOTIFY，但本质是getter不符合constant属性的实例无关要求）。

解决方法 #

根据你的需求（每个DataPoint实例有自己的timestamp、high、low，且不允许QML修改），你需要把constant=True替换为readOnly=True：

修改后的代码：

import sys
from PySide2.QtCore import Property, QObject
from PySide2.QtGui import QGuiApplication

class DataPoint(QObject):
    def __init__(self, timestamp=0, high=0, low=0, parent=None):
        super().__init__(parent)
        self._timestamp = timestamp
        self._high = high
        self._low = low

    @Property(float, readOnly=True)
    def timestamp(self):
        return self._timestamp

    @Property(float, readOnly=True)
    def high(self):
        return self._high

    @Property(float, readOnly=True)
    def low(self):
        return self._low

readOnly=True在PySide2中专门用于标记实例级别的只读属性，允许getter通过self访问实例变量，同时禁止QML对该属性进行写入操作，完全符合你的需求。

额外说明：如果确实需要类级别的常量

如果你真的要定义所有实例共享的类常量，在PySide2中需要把getter定义为静态方法或类方法，且不使用self参数：

class DataPoint(QObject):
    _DEFAULT_VALUE = 0.0

    @Property(float, constant=True)
    @staticmethod
    def defaultTimestamp():
        return DataPoint._DEFAULT_VALUE

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