PyQt6中uic.loadUi加载UI界面渲染异常问题求助

我通过uic.loadUi("ui.ui", self)加载QtDesigner生成的界面，程序可正常启动，但界面渲染显示异常——实际布局混乱，与预期的规整布局不符，请求帮忙排查原因。

Python代码 #

from PyQt6 import QtCore, QtWidgets, uic
from PyQt6.QtGui import QPixmap
from PyQt6.QtWidgets import QFileDialog, QMainWindow

from Controller import Controller


class Ui_Form(QMainWindow):

    def __init__(self,controller):
        self.controller = controller
        super(Ui_Form, self,).__init__()
        uic.loadUi('ui.ui',self)
        self.show()


if __name__ == "__main__":
    import sys
    app = QtWidgets.QApplication(sys.argv)
    Form = QtWidgets.QWidget()
    controller = Controller()
    ui = Ui_Form(controller)
    sys.exit(app.exec())

.ui文件内容 #

<ui version="4.0">
 <class>Form</class>
 <widget class="QWidget" name="Form">
  <property name="geometry">
   <rect>
    <x>0</x>
    <y>0</y>
    <width>899</width>
    <height>779</height>
   </rect>
  </property>
  <property name="windowTitle">
   <string>Form</string>
  </property>
  <layout class="QGridLayout" name="gridLayout">
   <item row="0" column="0">
    <widget class="QTabWidget" name="tabWidget">
     <property name="currentIndex">
      <number>1</number>
     </property>
     <widget class="QWidget" name="tabGeneral">
      <attribute name="title">
       <string>Tab 1</string>
      </attribute>
      <layout class="QGridLayout" name="gridLayout_2">
       <item row="0" column="0">
        <widget class="QFrame" name="frame">
         <property name="frameShape">
          <enum>QFrame::StyledPanel</enum>
         </property>
         <property name="frameShadow">
          <enum>QFrame::Raised</enum>
         </property>
         <layout class="QVBoxLayout" name="verticalLayout">
          <item>
           <widget class="QPushButton" name="addPhoto">
            <property name="text">
             <string>Add photo</string>
            </property>
           </widget>
          </item>
         </layout>
        </widget>
       </item>
       <item row="0" column="6">
        <widget class="QFrame" name="frame_2">
         <property name="frameShape">
          <enum>QFrame::StyledPanel</enum>
         </property>
         <property name="frameShadow">
          <enum>QFrame::Raised</enum>
         </property>
         <layout class="QHBoxLayout" name="horizontalLayout">
          <item>
           <widget class="QPushButton" name="back">
            <property name="text">
             <string>Back</string>
            </property>
           </widget>
          </item>
          <item>
           <widget class="QPushButton" name="next">
            <property name="text">
             <string>Next</string>
            </property>
           </widget>
          </item>
         </layout>
        </widget>
       </item>
       <item row="0" column="3" colspan="3">
        <spacer name="horizontalSpacer_2">
         <property name="orientation">
          <enum>Qt::Horizontal</enum>
         </property>
         <property name="sizeHint" stdset="0">
          <size>
           <width>324</width>
           <height>20</height>
          </size>
         </property>
        </spacer>
       </item>
       <item row="1" column="0">
        <spacer name="verticalSpacer">
         <property name="orientation">
          <enum>Qt::Vertical</enum>
         </property>
         <property name="sizeHint" stdset="0">
          <size>
           <width>20</width>
           <height>40</height>
          </size>
         </property>
        </spacer>
       </item>
       <item row="1" column="1" colspan="3">
        <widget class="QLabel" name="labelOfImage">
         <property name="minimumSize">
          <size>
           <width>500</width>
           <height>0</height>
          </size>
         </property>
         <property name="maximumSize">
          <size>
           <width>16777215</width>
           <height>16777176</height>
          </size>
         </property>
         <property name="text">
          <string>TextLabel</string>
         </property>
        </widget>
       </item>
      </layout>
     </widget>
     <widget class="QWidget" name="tabExifInfo">
      <attribute name="title">
       <string>Tab 2</string>
      </attribute>
      <layout class="QGridLayout" name="gridLayout_3">
       <item row="0" column="0">
        <widget class="QFrame" name="frame_4">
         <property name="frameShape">
          <enum>QFrame::StyledPanel</enum>
         </property>
         <property name="frameShadow">
          <enum>QFrame::Raised</enum>
         </property>
         <layout class="QGridLayout" name="gridLayout_4">
          <item row="0" column="0">
           <widget class="QListWidget" name="listExifInfo"/>
          </item>
         </layout>
        </widget>
       </item>
      </layout>
     </widget>
    </widget>
   </item>
  </layout>
 </widget>
 <resources/>
 <connections/>
</ui>

问题原因及修复方案 #

核心问题 #

1. 控件继承不匹配：.ui文件根控件是QWidget，但代码中Ui_Form继承了QMainWindow。QMainWindow有固定的布局结构（含菜单栏、中心部件等），直接加载QWidget的界面会导致布局冲突，控件无法正常排列。
2. 启动代码冗余：if __name__ == "__main__"中创建的Form = QtWidgets.QWidget()未被使用，属于无效代码。

修复方式 #

方式一：修改类继承匹配.ui文件

将Ui_Form的继承类改为QWidget，与.ui文件根控件保持一致：

class Ui_Form(QtWidgets.QWidget):
    def __init__(self, controller):
        self.controller = controller
        super().__init__()
        uic.loadUi('ui.ui', self)
        self.show()

同时移除启动代码中的冗余行：

if __name__ == "__main__":
    import sys
    app = QtWidgets.QApplication(sys.argv)
    controller = Controller()
    ui = Ui_Form(controller)
    sys.exit(app.exec())

方式二：保留QMainWindow，调整加载逻辑

若确实需要使用QMainWindow，可以将加载的QWidget设置为其中心部件：

class Ui_Form(QMainWindow):
    def __init__(self, controller):
        self.controller = controller
        super().__init__()
        widget = QtWidgets.QWidget()
        uic.loadUi('ui.ui', widget)
        self.setCentralWidget(widget)
        self.show()

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