PySide6使用snake_case/true_property时构造传参失效问题咨询

这是PySide6的已知实现缺陷，并非配置遗漏导致。

底层触发原因 #

• 未启用snake_case和true_property时，PySide控件构造函数的关键字参数赋值特性，直接通过Qt元对象系统匹配传入参数与C++层定义的Qt属性，找到对应setter完成自动赋值。
• 仅启用snake_case时，PySide会在Python层对所有对外暴露的方法、属性名做蛇形命名转换，隐藏原生C的属性名，但构造函数的关键字参数查找逻辑未做对应适配，仍然只会匹配C层的原生属性名，无法识别Python层的别名，因此抛出属性不存在的错误。
• 启用true_property（或同时启用两个特性）时，PySide会将所有Qt属性包装为标准Python property对象，覆盖了原有的元对象系统属性访问入口，构造函数的旧查找逻辑访问时出现空指针越界，直接触发段错误。

可行解决方案 #

目前官方尚未修复该问题，可通过以下两种方式规避：

• 放弃构造传参的便捷写法，构造控件后单独赋值属性，该写法和snake_case、true_property特性完全兼容：

from PySide6 import QtWidgets
from __feature__ import snake_case, true_property

app = QtWidgets.QApplication()
text = QtWidgets.QLabel('Example')
text.margin = 10

• 如果你需要保留构造传参的习惯，可以自行封装简易的控件工厂函数，在函数内部处理关键字参数的属性赋值：

def create_widget(cls, *args, **kwargs):
    widget = cls(*args)
    for key, value in kwargs.items():
        setattr(widget, key, value)
    return widget

# 使用示例
text = create_widget(QtWidgets.QLabel, 'Example', margin=10)

你不需要在两类特性之间二选一，通过上述封装方案即可同时保留两种写法的便利。

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