为何将QDialog实例化移至__init__后setWindowModality设置生效？

核心问题点 #

1. UI组件的线程规则：Qt要求所有UI对象（比如QDialog）必须在主线程创建和操作。如果原代码在子线程触发的槽函数里创建QDialog（哪怕是信号触发，若连接方式不当导致槽函数在子线程执行），属于非法操作，会导致show()失效，模态设置也不生效。
2. 对象生命周期与GC回收：如果原代码里QDialog是槽函数内的局部变量（或者虽然用self赋值，但槽函数执行完后对象失去有效引用），Python垃圾回收机制会立刻销毁它，对话框一闪而过，你误以为show()无效。
3. exec()的强制模态特性：QDialog的exec()方法是设计成强制模态的，它会直接覆盖你之前设置的NonModal属性，所以哪怕你改了模态设置，用exec()还是会弹出模态对话框。只有show()方法会遵循你设置的模态规则。

修改后生效的逻辑 #

把self.image_window = QDialog()移到类的__init__方法后：

• 对话框在主线程初始化（因为类实例是在主线程创建的），符合Qt的UI线程要求；
• 对话框作为类的成员变量，被长期持有引用，不会被垃圾回收；
• 此时调用show()就能正常显示非模态对话框，NonModal设置完全生效；如果之前误用了exec()，建议改成show()，因为exec()始终是模态的。

修改前（问题版本） #

from PyQt6.QtWidgets import QDialog, QApplication, QPushButton
from PyQt6.QtCore import Qt, QThread, pyqtSignal
import sys

class WorkerThread(QThread):
    trigger = pyqtSignal()

    def run(self):
        # 模拟线程任务
        self.sleep(2)
        self.trigger.emit()

class MainWindow(QDialog):
    def __init__(self):
        super().__init__()
        self.btn = QPushButton("触发对话框", self)
        self.btn.clicked.connect(self.start_thread)
        self.thread = WorkerThread()
        self.thread.trigger.connect(self.show_image_dialog)

    def start_thread(self):
        self.thread.start()

    def show_image_dialog(self):
        # 槽函数内创建对话框，违反UI线程规则+生命周期问题
        self.image_window = QDialog()
        self.image_window.setWindowModality(Qt.WindowModality.NonModal)
        # show()因对象被回收失效，改用exec()但强制模态
        self.image_window.exec()

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

修改后（正常版本） #

from PyQt6.QtWidgets import QDialog, QApplication, QPushButton
from PyQt6.QtCore import Qt, QThread, pyqtSignal
import sys

class WorkerThread(QThread):
    trigger = pyqtSignal()

    def run(self):
        self.sleep(2)
        self.trigger.emit()

class MainWindow(QDialog):
    def __init__(self):
        super().__init__()
        self.btn = QPushButton("触发对话框", self)
        self.btn.clicked.connect(self.start_thread)
        self.thread = WorkerThread()
        self.thread.trigger.connect(self.show_image_dialog)
        # 主线程初始化对话框，持有长期引用
        self.image_window = QDialog()
        self.image_window.setWindowModality(Qt.WindowModality.NonModal)

    def start_thread(self):
        self.thread.start()

    def show_image_dialog(self):
        # show()遵循模态设置，正常显示非模态对话框
        self.image_window.show()
        # 注意：若仍用exec()，会强制模态，忽略NonModal设置
        # self.image_window.exec()

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

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