如何在PyQt5的Qt Designer中单独设计子框架并导入主应用

一、Qt Designer中独立设计子组件 #

• 打开Qt Designer，新建文件时选择Widget或Frame作为基类（不要选MainWindow，避免多余的窗口框架）
• 按需设计子组件的布局、按钮、控件等，完成后保存为独立的.ui文件（比如sub_frame.ui）
• 使用pyuic5工具将.ui文件转换为Python代码：

  pyuic5 sub_frame.ui -o sub_frame.py
  

二、在主窗口中导入子组件 #

假设你已经有主窗口的.ui文件（比如main_window.ui）并转换为main_window.py，按以下步骤整合：

1. 主窗口预先留占位容器（推荐）
   在Qt Designer设计主窗口时，拖一个QWidget到需要放置子组件的位置，给它设置一个好记的对象名（比如sub_container），然后转换主窗口的.ui为py文件。

2. 代码中加载子组件
   在主窗口的业务代码中，导入子组件的类并实例化，将其挂载到预先设置的占位容器中：

   from PyQt5.QtWidgets import QMainWindow
   from main_window import Ui_MainWindow
   from sub_frame import Ui_Form  # 子组件转成py后的类名，默认是Ui_Form
   
   class MainApp(QMainWindow, Ui_MainWindow):
       def __init__(self):
           super().__init__()
           self.setupUi(self)
           
           # 实例化并加载子组件到占位容器
           self.sub_widget = Ui_Form()
           self.sub_widget.setupUi(self.sub_container)
   

3. 动态添加子组件（无需预先占位）
   如果主窗口的central widget已有布局，也可以直接动态添加子组件：

   from PyQt5.QtWidgets import QMainWindow, QVBoxLayout, QWidget
   from main_window import Ui_MainWindow
   from sub_frame import Ui_Form
   
   class MainApp(QMainWindow, Ui_MainWindow):
       def __init__(self):
           super().__init__()
           self.setupUi(self)
           
           # 创建子组件实例
           sub_ui = Ui_Form()
           sub_widget = QWidget()
           sub_ui.setupUi(sub_widget)
           
           # 获取主窗口central widget的布局，添加子组件
           layout = QVBoxLayout(self.centralWidget())
           layout.addWidget(sub_widget)
   

注意事项 #

• 子组件的基类必须是Widget/Frame，不能用MainWindow，否则会自带标题栏等窗口元素，无法作为子组件嵌入
• 确保主窗口的容器或central widget有布局，否则子组件可能无法正常显示
• 如果需要多个相同的子组件实例，直接重复实例化即可，互不影响

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