如何在PySide6 Designer中单独导出自定义（已提升）组件的Python代码

阿华AIGC实验室

2026-4-13

我完全懂你的困扰——Qt Designer默认只会导出整个UI文件的代码，没法直接把你在主窗口里精心设计的自定义子组件单独拆出来生成独立模块。不过有几个实用的方法可以解决这个问题，我给你一步步说清楚：

方法1：通过Designer提取单独UI文件生成组件代码

这是最省心的方法，相当于把你设计的自定义组件“克隆”成一个独立的UI文件，再单独导出代码：

打开你的主窗口UI文件，找到要导出的自定义组件，右键点击它选择「Copy」（复制）。
打开Qt Designer，新建一个Widget类型的空白UI文件（别选Main Window，就选普通Widget，因为你的组件本身就是一个子部件）。
在新的空白UI界面里，右键空白区域选择「Paste」（粘贴），这样你的自定义组件（包括所有子控件、布局、样式）就完整复制到这个新UI里了。
保存这个新UI文件，比如命名为my_custom_widget.ui。

用PySide6的UIC工具把这个UI转换成Python代码，打开终端执行：

pyside6-uic my_custom_widget.ui -o myCustomWidget.py

生成的myCustomWidget.py里会有一个Ui_Form类，你可以直接用它，或者基于它封装成业务类：

# 在myCustomWidget.py里补充业务类
from PySide6.QtWidgets import QWidget
from .myCustomWidget import Ui_Form  # 注意模块导入路径

class MyCustomWidget(QWidget, Ui_Form):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setupUi(self)
        # 这里可以加你的业务逻辑，比如信号槽绑定

回到原来的主窗口UI，右键那个自定义组件选择「Promote to...」，在弹窗里：
- 「Promoted class name」填MyCustomWidget
- 「Header file」填myCustomWidget（就是生成的Python模块名）
- 点击「Add」再「Promote」
之后再导出主窗口的UI代码，就会自动生成from myCustomWidget import MyCustomWidget的导入语句，完美实现组件分离。

方法2：手动拆分自动生成的主窗口代码

如果你已经导出了主窗口的完整Python代码，也可以手动把自定义组件的代码抽出来：

打开主窗口导出的Python文件（比如main_window.py），找到关于这个自定义组件的所有代码——包括setupUi里创建子控件、设置布局、调整样式、绑定信号槽的所有片段。

新建myCustomWidget.py文件，定义一个独立的组件类，继承自对应的父类（比如QWidget、QFrame）：

from PySide6.QtCore import Qt
from PySide6.QtWidgets import QWidget, QVBoxLayout, QLabel, QPushButton

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

    def setupUi(self):
        # 把从主窗口代码里抽出来的内容原封不动移到这里
        self.setObjectName(u"MyCustomWidget")
        self.resize(300, 100)
        self.verticalLayout = QVBoxLayout(self)
        self.verticalLayout.setObjectName(u"verticalLayout")
        self.title_label = QLabel(self)
        self.title_label.setObjectName(u"title_label")
        self.title_label.setText(u"我的自定义组件")
        self.title_label.setAlignment(Qt.AlignCenter)
        self.verticalLayout.addWidget(self.title_label)
        self.action_btn = QPushButton(self)
        self.action_btn.setObjectName(u"action_btn")
        self.action_btn.setText(u"点击我")
        self.verticalLayout.addWidget(self.action_btn)

回到主窗口代码，删掉原来属于这个组件的所有初始化代码，替换成导入并初始化新组件的逻辑：

# 主窗口代码顶部添加导入
from myCustomWidget import MyCustomWidget

# 在setupUi方法里替换原来的组件创建代码
self.my_custom_widget = MyCustomWidget(self)
self.my_custom_widget.setObjectName(u"my_custom_widget")
# 把组件添加到原来的布局里
self.main_layout.addWidget(self.my_custom_widget)