如何正确使用Qt Designer生成的*.py文件？

我是Python新手，用Qt Designer做了个大型GUI，程序运行慢，想改用Qt Designer导出的.py文件而不是loadUi()来提升性能。这个GUI每隔几周就要更新，所以希望把导出的UI文件作为独立文件，每次更新直接导出覆盖，不在里面手动改代码，而是在main.py的另一个类里加载UI类，再添加按钮点击这类业务逻辑。想确认这个思路对不对，以及正确的实现方式。

我目前的写法（认为是错误的）：
main.py

from PyQt5 import QtCore, QtGui, QtWidgets
from UI_MainWindow_Qt import Ui_MainWindow

#Main GUI
class Figure_Main(QtWidgets.QMainWindow, Ui_MainWindow):

    #create the figure with buttons and everything
    def __init__(self):
        QtWidgets.QMainWindow.__init__(self)
        self.setupUi(self)
        #if button gets clicked, call method1()

    def method1(self):
        #do some stuff'

UI_MainWindow_Qt.py

from PyQt5 import QtCore, QtGui, QtWidgets


class Ui_MainWindow(object):
    def setupUi(self, MainWindow):
        MainWindow.setObjectName("MainWindow")
        #setup the rest of the GUI's buttons and such

最初的写法里，Figure_Main类有几千行代码，文件结构混乱，于是改成了下面的写法：
main.py

#Main GUI
class Figure_Main(object):
    def setupUi(self, MainWindow):
        MainWindow.setObjectName("MainWindow")
        #setup the rest of the GUI's buttons and such (from Qt Designer)
        #if buttons get clicked, call method1() (manually added)

    def method1(self):
        #do some stuff

if __name__ == "__main__":

    #display main GUI window
    app = QtWidgets.QApplication(sys.argv) 
    MainWindow = QtWidgets.QMainWindow() 
    ui = Figure_Main() 
    ui.setupUi(MainWindow) 
    MainWindow.show()

你的思路完全正确，分离自动生成的UI代码和手动编写的业务逻辑是Qt开发的最佳实践，既能保证UI更新时不破坏业务代码，也能让代码结构更清晰。下面是正确的实现方式：

核心原则 #

• 永远不要修改Qt Designer导出的.py文件（比如UI_MainWindow_Qt.py），每次更新GUI后直接导出覆盖该文件即可。
• 业务逻辑（按钮点击事件、数据处理等）全部放在独立的类中，和UI代码完全分离。

正确代码实现 #

1. 保持UI文件原样（Qt Designer导出的UI_MainWindow_Qt.py） #

这个文件完全由Qt自动生成，不需要做任何修改：

from PyQt5 import QtCore, QtGui, QtWidgets

class Ui_MainWindow(object):
    def setupUi(self, MainWindow):
        MainWindow.setObjectName("MainWindow")
        # 以下是Qt自动生成的所有UI控件初始化代码
        self.pushButton = QtWidgets.QPushButton(MainWindow)
        self.pushButton.setObjectName("pushButton")
        # ... 其他UI控件代码
        self.retranslateUi(MainWindow)
        QtCore.QMetaObject.connectSlotsByName(MainWindow)

    def retranslateUi(self, MainWindow):
        _translate = QtCore.QCoreApplication.translate
        MainWindow.setWindowTitle(_translate("MainWindow", "MainWindow"))
        self.pushButton.setText(_translate("MainWindow", "点击按钮"))

2. main.py中编写业务逻辑类 #

这里有两种常用的实现方式，选一种即可：

方式一：多重继承（简洁直观）

继承QMainWindow和UI类，在初始化方法中完成UI初始化和信号绑定：

import sys
from PyQt5 import QtWidgets
from UI_MainWindow_Qt import Ui_MainWindow

class MainWindow(QtWidgets.QMainWindow, Ui_MainWindow):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 初始化UI
        self.setupUi(self)
        # 绑定按钮点击事件到业务方法
        self.pushButton.clicked.connect(self.method1)

    def method1(self):
        # 这里写具体的业务逻辑
        print("按钮被点击了，执行业务操作")

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

方式二：组合模式（更符合面向对象单一职责原则）

把UI类作为业务类的一个属性，适合更复杂的项目：

import sys
from PyQt5 import QtWidgets
from UI_MainWindow_Qt import Ui_MainWindow

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 创建UI实例并初始化
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)
        # 绑定信号到业务方法
        self.ui.pushButton.clicked.connect(self.method1)

    def method1(self):
        # 业务逻辑实现
        print("按钮触发业务逻辑")

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

关键说明 #

• 两种方式都能实现UI和逻辑分离，推荐根据项目复杂度选择：小型项目用多重继承更简洁，大型项目用组合模式更易维护。
• 信号绑定（比如clicked.connect）必须放在UI初始化完成之后，确保控件已经被创建。
• 每次更新GUI时，直接用Qt Designer导出覆盖UI_MainWindow_Qt.py即可，main.py里的业务代码完全不需要修改。

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