如何让子QWidget在应用关闭时自动执行自身清理任务？

我想要创建一个自定义子QWidget，使其在应用关闭、自身被销毁前自动执行清理任务，比如删除自身创建的临时文件、停止自主管理的线程等。

初始实现思路示例 #

import os
import sys
from PyQt5.QtWidgets import QTableWidget, QMainWindow, QWidget, QVBoxLayout, QPushButton, QApplication

class MyCustomWidget(QTableWidget):
    """自定义Widget示例（以表格组件为例）"""
    def __init__(self, parent=None):
        super().__init__(parent=parent)
        self._temp_filepath = "temporary_file.txt"

    def create_file(self):
        with open(self._temp_filepath, 'w') as file:
            file.write("临时文件内容")

    def _cleanup(self):
        try:
            os.remove(self._temp_filepath)
        except OSError:
            pass # 静默忽略清理错误

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        central_widget = QWidget()
        layout = QVBoxLayout(central_widget)
        self.setCentralWidget(central_widget)

        self.my_custom_widget = MyCustomWidget(parent=self)
        layout.addWidget(self.my_custom_widget)

        button = QPushButton('创建临时文件')
        button.clicked.connect(self.my_custom_widget.create_file)
        layout.addWidget(button)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    main_window = MainWindow()
    main_window.show()
    sys.exit(app.exec())

核心问题 #

如何实现点击关闭按钮或关闭应用时，自动运行MyCustomWidget._cleanup()？

已尝试的方案（无效） #

class MyCustomWidget(QTableWidget):
    """自定义Widget示例"""
    def __init__(self, parent=None):
        super().__init__(parent=parent)
        self._temp_filepath = "temporary_file.txt"

        self.destroyed.connect(self._cleanup) # 尝试监听销毁信号
        # 问题：该信号触发时机过晚，无法有效执行清理

    def create_file(self):
        with open(self._temp_filepath, 'w') as file:
            file.write("临时文件内容")

    # 问题：closeEvent仅适用于顶级Widget（如MainWindow），子组件无法触发
    def closeEvent(self, event):
        self._cleanup()
        event.accept()

    def _cleanup(self):
        try:
            os.remove(self._temp_filepath)
        except OSError:
            pass

• destroyed信号触发时机过晚，无法有效调用_cleanup()
• closeEvent()仅适用于顶级Widget，子组件无法通过该方法监听关闭事件

已知可行但不希望采用的方案 #

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        central_widget = QWidget()
        layout = QVBoxLayout(central_widget)
        self.setCentralWidget(central_widget)

        self.my_custom_widget = MyCustomWidget(parent=self)
        layout.addWidget(self.my_custom_widget)

        button = QPushButton('创建临时文件')
        button.clicked.connect(self.my_custom_widget.create_file)
        layout.addWidget(button)

    # 不希望在父窗口中手动调用子组件的清理方法
    def closeEvent(self, event):
        self.my_custom_widget._cleanup()
        event.accept()

if __name__ == '__main__':
    app = QApplication(sys.argv)
    main_window = MainWindow()
    main_window.show()
    
    # 不希望在应用入口处手动触发子组件清理
    app.aboutToQuit.connect(main_window.my_custom_widget._cleanup)
    
    sys.exit(app.exec())

我希望子组件能自主完成清理，无需父组件或应用入口触发该操作，同时该需求可扩展至线程等其他资源的回收。

解决方案 #

要让子组件完全自主管理清理逻辑，可通过以下两种信号结合实现：

修改后的自定义Widget代码 #

import os
import sys
from PyQt5.QtWidgets import QTableWidget, QApplication

class MyCustomWidget(QTableWidget):
    """自定义子Widget，自动执行清理任务"""
    def __init__(self, parent=None):
        super().__init__(parent=parent)
        self._temp_filepath = "temporary_file.txt"
        
        # 连接应用退出信号：应用关闭时触发清理
        QApplication.instance().aboutToQuit.connect(self._cleanup)
        # 连接自身销毁信号：组件被单独销毁时触发清理
        self.destroyed.connect(self._cleanup)

    def create_file(self):
        with open(self._temp_filepath, 'w') as file:
            file.write("临时文件内容")

    def _cleanup(self):
        """清理自定义资源（可扩展至线程、文件等）"""
        # 示例：停止并回收自定义线程
        # if hasattr(self, '_worker_thread') and self._worker_thread.isRunning():
        #     self._worker_thread.quit()
        #     self._worker_thread.wait()
        
        # 删除临时文件
        try:
            if os.path.exists(self._temp_filepath):
                os.remove(self._temp_filepath)
        except OSError:
            pass  # 静默忽略清理错误

关键说明 #

1. 监听应用退出信号：通过QApplication.instance().aboutToQuit.connect(self._cleanup)，确保应用关闭时无论子组件状态如何，都会触发清理逻辑。
2. 监听自身销毁信号：self.destroyed.connect(self._cleanup)处理子组件被单独销毁的场景（比如从布局中移除并删除），注意_cleanup方法仅处理自定义资源（文件、线程等），避免访问已销毁的Qt组件。
3. 完全自主管理：子组件无需父窗口或应用入口处的额外代码，所有清理逻辑由自身维护，符合组件封装的设计原则。

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