QEventLoop.exec()的简单介绍
QEventLoop.exec()，手动启动 Qt 的事件循环并阻塞当前线程，直到事件循环退出（返回退出码），它是 Qt 中处理事件（如用户交互、信号槽、定时器等）的核心机制之一。
Qt 程序默认会在 QApplication.exec() 中启动全局主事件循环，而 QEventLoop 是局部事件循环，用于在需要临时等待某个操作完成（又不想阻塞整个程序）的场景下手动创建和启动。
QEventLoop.exec() 核心特性与使用要点
- 阻塞特性 ：调用
exec()后，当前代码执行流会被阻塞在该行，直到调用QEventLoop.quit()退出事件循环，后续代码才会继续执行。 - 事件处理能力 ：阻塞期间，该局部事件循环会正常处理 Qt 的各类事件（信号槽触发、界面刷新、定时器事件等），保证界面不会卡顿，这是它和普通
time.sleep()的核心区别（sleep()会阻塞整个线程，无法处理事件）。 - 返回值 ：
exec()会返回一个退出码（整数类型），通常用于标识事件循环的退出原因（如正常退出、异常退出），默认正常退出返回 0。 - 使用流程 ：创建
QEventLoop实例 → 绑定退出触发条件（通常是信号关联quit()） → 调用exec()启动 / 阻塞 → 事件处理完成后自动 / 手动触发quit()退出循环。
简单示例
from PySide6.QtWidgets import QApplication, QPushButton
from PySide6.QtCore import QEventLoop, QTimer
import sys
app = QApplication(sys.argv)
# 1. 创建局部事件循环实例
loop = QEventLoop()
# 2：通过按钮点击手动退出事件循环（拓展）
btn = QPushButton("点击退出事件循环")
btn.clicked.connect(loop.quit)
btn.show()
# 3. 启动事件循环，阻塞当前线程（3秒内此处卡住，直到loop.quit()被调用）
print("启动事件循环，阻塞线程")
exit_code = loop.exec()
# 4. 退出事件循环后，继续执行后续代码
print(f"事件循环退出，退出码：{exit_code}，后续代码继续执行")
# 5. 再次启动事件循环，等待按钮点击后退出
loop.exec()
print("再次启动事件循环，等待按钮点击后退出")
print("按钮被点击，事件循环退出")
# 6. 退出事件循环后，继续执行后续代码
print("2秒钟后主线程循环退出")
QTimer.singleShot(2000, app.quit) # 1秒后退出主线程循环
sys.exit(app.exec())常见使用场景
- 临时等待异步操作完成：如等待网络请求（Qt 网络模块）、子线程任务执行完毕，避免整个程序阻塞。
- 弹窗等待用户交互：自定义简易弹窗时，需要等待用户点击确认 / 取消后再继续后续逻辑，可通过局部事件循环实现。
- 批量处理短时任务且需要实时刷新界面：在循环中插入局部事件循环，保证每一步任务完成后界面能及时刷新。
总结
QEventLoop.exec()是启动局部 Qt 事件循环的核心方法，阻塞当前线程但不阻塞事件处理；- 必须通过
quit()触发退出，否则会一直阻塞； - 区别于全局的
QApplication.exec()，用于临时场景，不建议嵌套过多（可能导致逻辑复杂）。
QEventLoop.exec()在子线程中的应用
特别典型的demo代码：
python
import sys
from PySide6.QtCore import QThread, QEventLoop, Signal
from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout, QPushButton
class MyThread(QThread):
stop_signal = Signal() # 定义一个停止信号（最好是通过此信号停止线程）
def __init__(self, idx):
super().__init__()
self.idx = idx
self.is_running = True
self.loop = None
# self.loop = QEventLoop() # 不能在这里初始化事件循环，因为实例化还没有完成
# self.stop_signal.connect(self.stop) # 同样的，也不能在这里连接停止信号，因为实例化还没有完成
def run(self):
self.stop_signal.connect(self.stop) # 连接停止信号，在信号触发时停止线程
print(f"MyThread {self.idx} is running ")
# 移除冗余的while循环，直接启动一次事件循环即可实现持续阻塞
if not self.loop:
print(f"初始化 MyThread {self.idx} 事件循环")
self.loop = QEventLoop() # 必须在实例化以后再初始化事件循环
if self.is_running:
self.loop.exec() # 阻塞等待，直到调用loop.quit()
print(f"MyThread {self.idx} 开始退出")
def stop(self):
"""安全停止线程"""
if not self.is_running:
return
self.is_running = False
self.loop.quit() # 终止事件循环，解除exec()的阻塞
self.wait() # 等待线程完全退出，释放资源
print(f"MyThread {self.idx} 已安全退出")
def create_thread():
global i
thread = MyThread(i)
threads.append(thread)
thread.start()
i += 1
def stop_thread():
"""停止已创建的线程"""
if len(threads) > 0:
# threads.pop(0).stop() # 更符合规范的是用下面的信号停止线程
threads.pop(0).stop_signal.emit() # 用信号停止线程，而不是直接操作线程对象，更符合规范
else:
print("无运行中的线程")
if __name__ == "__main__":
app = QApplication(sys.argv)
i = 0
threads = []
form = QWidget()
form.setWindowTitle("线程创建与停止示例")
layout = QVBoxLayout()
form.setLayout(layout)
# 创建"创建线程"按钮
btn_create = QPushButton("创建线程")
btn_create.clicked.connect(create_thread)
layout.addWidget(btn_create)
# "停止线程"按钮，提供停止线程的入口
btn_stop = QPushButton("停止线程")
btn_stop.clicked.connect(stop_thread)
layout.addWidget(btn_stop)
form.show()
sys.exit(app.exec())- 代码注释中，"不能在这里初始化事件循环，因为实例化还没有完成"的含义：
核心原因 1：QThread 实例化未完成，线程上下文尚未建立。
__init__ 方法的执行是在主线程（创建 MyThread 实例的线程）中完成的，而非后续该自定义线程要运行的子线程上下文。此时 MyThread 实例还在构造过程中，QThread 对应的子线程尚未启动（需调用 start() 方法才会启动子线程并执行 run() 方法），线程的专属事件循环上下文、资源尚未建立。** ****QEventLoop 是 "绑定线程上下文" 的组件，它需要依附于一个已经启动并存在的线程环境，在 __init__ 中初始化会导致 QEventLoop 错误地绑定到主线程**，而非目标子线程，失去其在子线程中处理事件的意义。
核心原因 2：QObject 派生类的线程亲和性（Thread Affinity）限制
QEventLoop 是 QObject 的派生类，QObject 有 "线程亲和性" 特性（即一个 QObject 实例默认属于创建它的线程）。在 __init__ 中创建 self.loop = QEventLoop()，会让这个 QEventLoop 实例的线程亲和性绑定到主线程 （因为 __init__ 在主线程执行）。后续即使启动了 MyThread 子线程，这个 QEventLoop 也无法正常在子线程中运转（PyQt/PySide 中 QObject 的线程亲和性修改有严格限制，且事件循环无法跨线程正常工作），会导致事件处理异常、线程阻塞甚至程序崩溃。
- 类似容易犯的错误：
在__init__ 中连接信号与槽也会导致运行不成功，因为在__init__ 阶段，信号和槽尚未完全创建。