使用pyside6-uic转换.ui文件后类继承object而非QWidget的问题

这并非异常问题，而是PySide6的pyside6-uic工具的默认设计逻辑，以下是详细说明和相关排查/使用方案：

核心原因 #

PySide6（以及PyQt）的uic工具生成的Ui_*类本身仅作为界面配置类存在，设计为继承object而非Qt控件类。它的核心作用是通过setupUi方法，将界面元素挂载到一个已存在的Qt控件实例（比如QWidget、QMainWindow）上，实现界面与业务逻辑的分离。

正确使用方式 #

你可以通过两种方式基于生成的Ui_Form创建可用的窗口组件：

方式1：组合式（推荐） #

将Ui类作为窗口类的属性，保持逻辑与界面的清晰分离：

from PySide6.QtWidgets import QWidget, QApplication
from ui_widget import Ui_Form
import sys

class MyWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.ui = Ui_Form()
        self.ui.setupUi(self)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MyWidget()
    window.show()
    sys.exit(app.exec())

方式2：多继承式 #

让自定义窗口类同时继承Qt控件类和Ui类：

from PySide6.QtWidgets import QWidget, QApplication
from ui_widget import Ui_Form
import sys

class MyWidget(QWidget, Ui_Form):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setupUi(self)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MyWidget()
    window.show()
    sys.exit(app.exec())

排查确认点 #

1. 验证ui文件结构：你的widget.ui中根组件为<widget class="QWidget" name="Form">，结构完全正确，无需修改。
2. 检查uic命令参数：你使用的pyside6-uic widget.ui -o ui_widget.py是标准转换命令，没有特殊参数会改变类的继承逻辑。
3. 版本兼容性：你的PySide6 6.4.3是稳定版本，该生成逻辑在全版本PySide6中保持一致，不存在版本bug。

内容的提问来源于stack exchange，提问作者Nicolas M.