使用QUILoader导入PySide6自定义控件失败的问题排查

问题背景 #

使用PySide6开发电机载物台控制器GUI，需将最多3个相同的「载物台窗口」集成到主「控制器窗口」中。采用QUiLoader直接加载QtDesigner制作的ui文件，当前控制器窗口可正常显示，但指定承载载物台的widgetPlatineX区域始终为空，控制台无报错。

原载物台窗口代码 #

from PySide6 import QtCore, QtWidgets
from PySide6.QtUiTools import QUiLoader

loader = QUiLoader()

dic_valeur = {0:0.01, 1:0.05, 2:0.1, 3:0.5, 4:1, 5:5}

class MainWindowPlatine(QtWidgets.QWidget): #An object wrapping around our ui
    def __init__(self, parent = None):
        super().__init__()
        self.ui = loader.load("Platine/Ui_main_window_platine.ui", MainWindowPlatine)
        self.parent = parent
        self.change_position()
        self.ui.horizontalSliderRelatif.valueChanged.connect(self.change_position)

    def show(self):
        self.ui.show()

    def change_position(self):
        int = self.ui.horizontalSliderRelatif.value()
        valeur = str(dic_valeur[int])
        self.ui.lineEditValeurRelatif.setText(valeur)

    def load(self, chemin):
        self.ui = loader.load(chemin)

原控制器窗口代码 #

from PySide6 import QtCore, QtWidgets
from PySide6.QtWidgets import QHBoxLayout, QPushButton
from PySide6.QtUiTools import QUiLoader
from Platine.main_window_platine import MainWindowPlatine

loader = QUiLoader()

class MainWindowPorteEchantillon(QtWidgets.QWidget): #An object wrapping around our ui
    def __init__(self):
        super().__init__()
        self.ui = loader.load("Ui_main_window_porte_echantillon.ui", None)
        self.PlatineX = MainWindowPlatine()

        layout_platineX = QHBoxLayout()
        layout_platineX.addWidget(self.PlatineX)
        self.ui.widgetPlatineX.setLayout(layout_platineX)

    def show(self):
        self.ui.show()   

问题分析 #

1. 子窗口类结构错误：MainWindowPlatine作为QWidget子类，内部加载了独立的self.ui控件，但未将该控件绑定为自身的子部件。当把MainWindowPlatine实例添加到布局时，实际添加的是一个空的QWidget，真正的载物台UI并未嵌入。
2. UI加载父参数错误：loader.load("Platine/Ui_main_window_platine.ui", MainWindowPlatine)中，第二个参数传入的是类本身而非当前实例，导致加载的UI没有正确挂载到父控件上。

修正方案 #

1. 修正载物台窗口类 #

将加载的UI部件直接挂载到当前实例，确保UI内容显示在MainWindowPlatine控件内部：

from PySide6 import QtCore, QtWidgets
from PySide6.QtUiTools import QUiLoader

loader = QUiLoader()

dic_valeur = {0:0.01, 1:0.05, 2:0.1, 3:0.5, 4:1, 5:5}

class MainWindowPlatine(QtWidgets.QWidget):
    def __init__(self, parent = None):
        super().__init__(parent)
        # 将加载的UI父对象设为当前实例，让UI内容嵌入到当前控件中
        self.ui = loader.load("Platine/Ui_main_window_platine.ui", self)
        self.change_position()
        self.ui.horizontalSliderRelatif.valueChanged.connect(self.change_position)

    def change_position(self):
        slider_value = self.ui.horizontalSliderRelatif.value()
        valeur = str(dic_valeur[slider_value])
        self.ui.lineEditValeurRelatif.setText(valeur)

    def load(self, chemin):
        # 重新加载时同样绑定父对象
        self.ui = loader.load(chemin, self)

2. 优化控制器窗口布局设置 #

若QtDesigner中已给widgetPlatineX设置过布局，需先清空避免冲突，再添加新布局：

from PySide6 import QtCore, QtWidgets
from PySide6.QtWidgets import QHBoxLayout
from PySide6.QtUiTools import QUiLoader
from Platine.main_window_platine import MainWindowPlatine

loader = QUiLoader()

class MainWindowPorteEchantillon(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.ui = loader.load("Ui_main_window_porte_echantillon.ui", self)
        self.PlatineX = MainWindowPlatine()

        # 清空widgetPlatineX原有布局（若存在）
        if self.ui.widgetPlatineX.layout() is not None:
            old_layout = self.ui.widgetPlatineX.layout()
            while old_layout.count():
                child = old_layout.takeAt(0)
                if child.widget():
                    child.widget().deleteLater()
            del old_layout

        layout_platineX = QHBoxLayout()
        layout_platineX.addWidget(self.PlatineX)
        self.ui.widgetPlatineX.setLayout(layout_platineX)

    def show(self):
        self.ui.show()   

其他可行集成方法 #

• QtDesigner控件提升：在控制器窗口的QtDesigner界面中，选中widgetPlatineX右键选择「提升为...」，指定MainWindowPlatine类的路径，加载UI时会自动将该widget替换为载物台窗口类，无需手动添加布局。
• 使用容器控件管理：若需切换显示载物台，可采用QTabWidget（每个标签页对应一个载物台）或QStackedWidget（通过代码切换显示），简化多载物台的管理逻辑。

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