PySide6使用pyside6-uic控件不显示及简化调用方法问询

背景 #

原本基于PyQt6+pyqtgraph开发项目，因PySide6具备所需特定方法，决定进行框架迁移。在PyQt6环境中，通过以下方式加载UI文件后，可直接通过self.[控件名]调用Qt Designer中创建的控件：

from pyqtgraph.Qt import uic
uic.loadUi('uifile.ui', self)

迁移初期问题 #

迁移到PySide6后，按照官方文档使用命令生成UI代码文件：

pyside6-uic "test.ui" > ui_test.py

生成包含Ui_MainWindow类的ui_test.py后，编写示例代码运行仅显示空主窗口，控件完全未加载。排查后发现是类的构造方法名写错——将__init__误写为__init，修正后控件可正常加载，但只能通过self.ui.buttonBox这类带self.ui前缀的方式调用控件。

实现直接调用控件的简便方法 #

为避免手动修改大量控件引用代码，通过遍历ui实例的__dict__属性，将非私有控件属性直接绑定到self上，实现无需self.ui前缀直接调用控件的效果。示例代码如下：

from PySide6.QtWidgets import QMainWindow
from ui_test import Ui_MainWindow

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)
        
        # 将ui的控件属性绑定到self
        for name, widget in self.ui.__dict__.items():
            # 过滤私有属性和非控件对象
            if not name.startswith('_') and hasattr(widget, 'objectName'):
                setattr(self, name, widget)
        
        # 现在可直接调用控件
        self.buttonBox.clicked.connect(self.on_button_clicked)
    
    def on_button_clicked(self):
        print("按钮被点击")

注意事项 #

• 遍历过程中需过滤以_开头的私有属性，避免将UI类内部的私有变量绑定到self上
• 可通过hasattr(widget, 'objectName')进一步筛选控件对象，排除非控件属性

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