PyQt5中如何实现.ui生成的UI代码与应用业务逻辑的分层隔离

1. Fan实例的实例化位置 #

两种方式均可以正常运行，更推荐在GUI类外部实例化Fan，彻底实现UI层和服务层的解耦。

• 若在GUI类内部实例化Fan，后续如果需要多窗口复用Fan实例、替换Fan的业务实现逻辑时，需要修改GUI代码，违反开闭原则。
• 外部实例化Fan完全可以通过信号槽和GUI建立连接，GUI只需要暴露自身的交互信号（比如启动按钮点击、停止按钮点击信号），Fan类暴露对应的业务槽函数和自身的状态信号，二者在入口代码中完成绑定即可，互相不需要知道对方的内部实现。

2. 自检逻辑的线程处理 #

必须将fan.checking()方法放到独立线程中运行。

• 哪怕自检逻辑当前运行速度很快，只要涉及硬件交互类的IO操作，就存在阻塞主线程事件循环的可能，一旦阻塞会直接导致整个UI卡死无响应。
• 由于Fan是QObject子类，自检进度可以通过Fan自定义的进度信号直接发送到主线程，Qt的信号槽天生支持跨线程安全传递，不需要自己做线程同步，直接连接到进度条的setValue槽即可正常更新。

3. 无阻塞Fan类的线程挂载方式 #

不需要重写QThread的run方法，直接使用moveToThread方法将Fan实例挂载到独立线程即可：

• 实例化一个空白的QThread对象，调用fan.moveToThread(fan_thread)将Fan实例的事件循环绑定到子线程。
• 所有对Fan业务方法的调用全部通过信号槽触发，不要直接调用Fan的实例方法，触发后方法会自动在子线程的事件循环中执行，不会影响主线程UI响应。
• motor硬件启动后的持续运行状态不需要额外处理，只要停止指令通过信号槽发送给Fan，就会在子线程中正常执行停止逻辑。

最简实现示例 #

if __name__ == "__main__":
    import sys
    from PyQt5.QtWidgets import QApplication
    from PyQt5.QtCore import QThread

    app = QApplication(sys.argv)
    # 分别实例化UI和服务层对象
    main_window = MainWindow()
    fan = Fan()
    # 创建子线程
    fan_thread = QThread()
    # 将Fan实例挂载到子线程
    fan.moveToThread(fan_thread)

    # 绑定UI交互信号到服务层槽函数
    main_window.start_btn.clicked.connect(fan.start)
    main_window.stop_btn.clicked.connect(fan.stop)
    # 绑定服务层状态信号到UI更新槽函数
    fan.check_progress.connect(main_window.progress_bar.setValue)
    fan.check_result.connect(main_window.check_result_label.setText)
    fan.speed_updated.connect(main_window.speed_label.setText)

    # 配置线程退出时的资源清理逻辑
    fan_thread.finished.connect(fan.deleteLater)
    # 启动子线程和主窗口
    fan_thread.start()
    main_window.show()

    sys.exit(app.exec())

核心注意事项 #

• 服务层代码绝对不要直接操作任何UI控件，所有状态变更全部通过自定义信号抛出，由UI层自己决定如何展示数据。
• 不要在子线程中执行任何UI更新操作，所有UI修改必须在主线程中执行。
• 程序退出前先向Fan发送停止指令，确认硬件停止运行后再退出子线程，最后关闭主窗口，避免硬件出现异常状态。

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