PySide6，QCoreApplication::aboutToQuit与QtQore.qAddPostRoutine：退出前后的清理工作

一、 QCoreApplication::aboutToQuit

Qt应用实例QCoreApplication的aboutToQuit信号是在应用的主循环 exec() 退出前发射的信号，把这个信号连接到一个槽函数，就可以在程序真正退出之前执行一些清理工作，比如：

保存用户配置（如窗口大小、偏好设置）；
关闭打开的文件 / 数据库连接；
终止后台线程并释放资源；
释放动态分配的内存等。

使用范例：

python 复制代码

import sys

from PySide6.QtCore import QThread
from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout, QPushButton


class WorkThread(QThread):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.is_running = False

    def run(self):
        self.is_running = True
        while self.is_running:
            QThread.msleep(1000)
            print("线程正在运行")

def create_thread():
    app.work_thread = WorkThread()
    app.work_thread.start()

def about_to_quit():
    print("应用即将退出")
    app.work_thread.is_running = False  # 停止线程
    app.work_thread.wait()   # 等待线程结束
    app.work_thread.deleteLater()  # 释放线程对象
    

if __name__ == "__main__":
    app = QApplication(sys.argv)
    form = QWidget()
    layout = QVBoxLayout()
    form.setLayout(layout)

    # 创建"创建线程"按钮
    btn_create = QPushButton("创建线程")
    btn_create.clicked.connect(create_thread)
    layout.addWidget(btn_create)

    # "停止线程"按钮，提供停止线程的入口
    btn_quit = QPushButton("退出应用")
    btn_quit.clicked.connect(app.quit)
    layout.addWidget(btn_quit)
    
    app.aboutToQuit.connect(about_to_quit)  # 应用即将退出时，执行about_to_quit函数

    form.show()
    sys.exit(app.exec())

二、QtQore.qAddPostRoutine

qAddPostRoutine是 Qt 框架 中的一个底层函数，主要用于在程序退出（更准确地说是 Qt应用的主事件循环结束）时，注册需要执行的 "清理函数"。

命名拆解 ：
- q：Qt 基础函数的前缀，代表这是 Qt 核心库提供的函数；
- Add："添加"，即注册一个函数；
- PostRoutine："退出后的例行操作"，指程序退出阶段要执行的逻辑。
核心作用 ：给程序注册一个回调函数，当 Qt 应用的 QCoreApplication::exec() 结束（主循环退出）、程序即将完全退出时，自动执行这个回调函数，常用于释放全局资源、清理临时文件、记录退出日志等。
执行顺序 ：当你关闭程序（主循环 exec() 已经结束），会先执行 cleanupFunction，再完成程序的最终退出。

关键特点：

注册的函数无参数、无返回值 （必须是 void (*)() 类型）；
可以注册多个函数，Qt 会按注册顺序的逆序执行（后注册的先执行）；
属于 Qt 底层接口，通常用于框架级 / 全局级的清理。

三、二者的核心对比解析

首先明确两者的共性：都是 Qt 中用于处理 "程序退出前逻辑" 的机制，但核心差异在于执行阶段、触发条件、使用方式：

特性	`aboutToQuit.connect()`	`qAddPostRoutine`
所属层级	Qt 信号槽机制（应用层）	Qt 底层 C 函数（框架层）
执行时机	主事件循环 `exec()` 退出前、程序真正退出之前	主事件循环 `exec()` 退出后、程序真正退出前夕
触发条件	调用 `quit()`/`exit()`、关闭最后一个窗口等 "主动退出" 场景	无论主动 / 被动退出（如崩溃、强制终止），只要 Qt 主循环结束都会触发
参数 / 返回值	槽函数可自定义（但通常无参），支持 Qt 信号槽特性	只能注册 `void (*)()` 类型的无参无返回值函数
执行顺序	按 `connect()` 顺序执行（先连先执行）	按注册顺序逆序执行（后注册先执行）
线程环境	在主线程执行（Qt 主线程事件循环中）	在主线程执行（底层清理阶段）
能否取消	可通过 `disconnect()` 取消绑定	一旦注册无法取消，直到程序退出

差别总结：

aboutToQuit：是 "退出准备阶段"，此时 Qt 主事件循环还在运行，所有 Qt 核心对象（如 QObject、QWidget）都还存活，可正常操作 Qt 组件（比如弹窗提示、保存配置到 QSettings）。
qAddPostRoutine：是 "退出收尾阶段"，此时 Qt 主事件循环已结束，部分 Qt 高层对象（如 QWidget）可能已销毁，不建议操作 Qt 组件，仅适合纯 C 层面的清理（如释放全局内存、关闭 C 语言打开的文件句柄）。

实战示例对比：

python 复制代码

import sys
import tempfile
import os
import time

from PySide6.QtCore import (
    QCoreApplication,
    QTimer,
    QSettings,
    qAddPostRoutine  # 导入 qAddPostRoutine 函数
)
from PySide6.QtWidgets import QApplication, QPushButton


# -------------------------- 1. 定义 aboutToQuit 槽函数（Qt层面清理） --------------------------
def on_about_to_quit():
    """程序退出前（主循环仍运行）执行：保存Qt配置、操作Qt对象"""
    print("\n【1】触发 aboutToQuit 信号 - Qt主循环仍在运行")

    # 示例1：保存用户配置（Qt对象仍可用）
    settings = QSettings("MyPySideApp", "UserConfig")
    settings.setValue("last_operation", "程序正常退出")
    settings.sync()
    print("✅ 已保存用户配置到 QSettings")

    # 示例2：打印当前Qt应用状态（验证Qt对象存活）
    app = QCoreApplication.instance()
    print(f"✅ Qt应用状态：{app.isQuitLockEnabled()}")
    time.sleep(5)


# -------------------------- 2. 定义 qAddPostRoutine 清理函数（底层清理） --------------------------
# 全局变量：模拟临时资源（比如临时文件、C扩展的内存等）
temp_file_path = None


def cleanup_temp_file():
    """程序退出前夕（主循环已结束）执行：清理底层资源"""
    print("\n【2】触发 qAddPostRoutine - 此时Qt应用主循环已结束")

    # 示例：删除临时文件（纯Python/C底层操作，不依赖Qt对象）
    if temp_file_path and os.path.exists(temp_file_path):
        try:
            os.remove(temp_file_path)
            print(f"✅ 已删除临时文件：{temp_file_path}")
        except Exception as e:
            print(f"❌ 删除临时文件失败：{e}")
    else:
        print("✅ 无临时文件需要清理")
    time.sleep(5)


def cleanup_log():
    """第二个 qAddPostRoutine 函数：验证逆序执行"""
    print("【3】再次触发 qAddPostRoutine")
    time.sleep(5)  # 模拟耗时操作，比如清理日志
    print("\n【4】所有工作已完成，程序即将结束")


# -------------------------- 3. 主程序逻辑 --------------------------
if __name__ == "__main__":
    # 创建Qt应用
    app = QApplication(sys.argv)

    # 模拟业务操作：创建临时文件（代表需要清理的资源）
    temp_file = tempfile.NamedTemporaryFile(delete=False, suffix=".tmp")
    temp_file.write("临时测试数据".encode("utf-8"))
    temp_file.close()
    temp_file_path = temp_file.name
    print(f"📌 程序启动，创建临时文件：{temp_file_path}")

    # 绑定 aboutToQuit 信号（Qt层面清理）
    app.aboutToQuit.connect(on_about_to_quit)

    # 连接按钮点击信号和应用退出函数
    button = QPushButton("点击退出")
    button.clicked.connect(app.quit)
    button.show()

    # 注册 qAddPostRoutine 清理函数（底层清理，注意注册顺序）
    qAddPostRoutine(cleanup_temp_file)  # 第一个注册
    qAddPostRoutine(cleanup_log)  # 第二个注册

    # 启动主事件循环
    print("程序运行中...")
    exit_code = app.exec()

    # 主循环结束后打印（验证主循环生命周期）
    print(f"\n##########################\n✅主循环已结束，退出码：{exit_code}\n##########################\n")

    sys.exit(exit_code)

适用场景：

场景	推荐使用	原因
保存用户配置、弹窗提示、关闭 Qt 数据库连接	`aboutToQuit.connect()`	此时 Qt 对象仍存活，可正常调用 Qt API
释放 C 语言全局内存、关闭原生文件句柄、清理非 Qt 资源	`qAddPostRoutine`	主循环结束后仍能执行，且不受 Qt 对象销毁影响，适合底层清理
程序可能异常崩溃的场景	`qAddPostRoutine`	即使主动 quit 未触发，主循环结束后仍会执行（部分崩溃场景可能不生效）
需要灵活取消退出逻辑	`aboutToQuit.connect()`	可通过 disconnect 取消绑定，而 qAddPostRoutine 注册后无法取消

总结

执行时机是核心 ：aboutToQuit 在主循环退出前（Qt 对象存活），qAddPostRoutine 在主循环退出后（Qt 对象可能已销毁）；
使用场景区分 ：Qt 层面的清理用 aboutToQuit，纯 C 底层资源清理用 qAddPostRoutine。

总之：aboutToQuit 是 "Qt 退出前的优雅收尾"，qAddPostRoutine 是 "程序退出前的最后底层清理"。