PyQt5中多窗口的显示与隐藏问题求助

我之前做过一个PyQt5的复杂多窗口项目，深知官方文档在这块的缺失有多头疼！针对你遇到的大量窗口管理、输入参数后运行算法的场景，给你几个经过实践验证的解决方案：

1. 用QStackedWidget做窗口切换（最推荐） #

如果你需要的是窗口之间的切换逻辑（比如输入窗口→结果窗口→参数调整窗口这种线性/循环流程），QStackedWidget绝对是最优选择。它可以把多个窗口作为子部件收纳其中，同一时间只显示一个窗口，切换起来非常丝滑，还能避免窗口满天飞的问题。

举个简单的示例：

import sys
from PyQt5.QtWidgets import (QApplication, QWidget, QPushButton, 
                             QStackedWidget, QVBoxLayout, QLineEdit)

class InputWindow(QWidget):
    def __init__(self):
        super().__init__()
        layout = QVBoxLayout()
        self.param_input = QLineEdit()
        self.param_input.setPlaceholderText("请输入优化参数")
        self.btn_run = QPushButton("提交参数，运行算法")
        layout.addWidget(self.param_input)
        layout.addWidget(self.btn_run)
        self.setLayout(layout)

class ResultWindow(QWidget):
    def __init__(self):
        super().__init__()
        layout = QVBoxLayout()
        self.btn_back = QPushButton("返回参数输入窗口")
        layout.addWidget(self.btn_back)
        self.setLayout(layout)

class MainController(QWidget):
    def __init__(self):
        super().__init__()
        self.stacked_widget = QStackedWidget()
        
        # 初始化所有窗口并添加到StackedWidget
        self.input_win = InputWindow()
        self.result_win = ResultWindow()
        self.stacked_widget.addWidget(self.input_win)
        self.stacked_widget.addWidget(self.result_win)
        
        # 绑定切换逻辑，同时处理参数获取和算法触发
        self.input_win.btn_run.clicked.connect(self.handle_run_algorithm)
        self.result_win.btn_back.clicked.connect(lambda: self.stacked_widget.setCurrentWidget(self.input_win))
        
        main_layout = QVBoxLayout()
        main_layout.addWidget(self.stacked_widget)
        self.setLayout(main_layout)
        self.setWindowTitle("多窗口管理示例")
        
    def handle_run_algorithm(self):
        # 获取用户输入的参数
        param = self.input_win.param_input.text()
        if not param:
            print("请输入有效参数！")
            return
        # 这里替换成你的优化算法逻辑（注意耗时算法要放子线程！）
        print(f"正在运行优化算法，参数：{param}")
        # 切换到结果窗口
        self.stacked_widget.setCurrentWidget(self.result_win)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    controller = MainController()
    controller.show()
    sys.exit(app.exec_())

2. 手动管理窗口的show()/hide()（灵活度高） #

如果你的窗口之间是独立的、非流程化的（比如随时可能弹出的参数配置窗口、日志窗口），可以手动用show()和hide()控制，但一定要注意窗口实例的复用，别每次需要都重新创建（既浪费资源又容易出bug）。

可以用一个管理器类来统一维护所有窗口的实例：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QPushButton, QVBoxLayout

class WindowManager:
    def __init__(self):
        self._windows = {}
    
    def get_window(self, window_cls):
        # 单例模式，确保每个窗口只创建一次
        if window_cls not in self._windows:
            self._windows[window_cls] = window_cls()
        return self._windows[window_cls]
    
    def show(self, window_cls, hide_others=False):
        target_win = self.get_window(window_cls)
        target_win.show()
        # 如果需要显示当前窗口时隐藏其他所有窗口
        if hide_others:
            for cls, win in self._windows.items():
                if cls != window_cls:
                    win.hide()

class ParamWindow(QWidget):
    def __init__(self):
        super().__init__()
        layout = QVBoxLayout()
        self.btn_start = QPushButton("启动算法")
        layout.addWidget(self.btn_start)
        self.setLayout(layout)

class LogWindow(QWidget):
    def __init__(self):
        super().__init__()
        layout = QVBoxLayout()
        self.btn_close = QPushButton("关闭日志")
        layout.addWidget(self.btn_close)
        self.setLayout(layout)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    manager = WindowManager()
    
    param_win = manager.get_window(ParamWindow)
    log_win = manager.get_window(LogWindow)
    
    # 绑定按钮逻辑：启动算法时显示日志窗口，不隐藏参数窗口
    param_win.btn_start.clicked.connect(lambda: manager.show(LogWindow))
    log_win.btn_close.clicked.connect(log_win.hide)
    
    param_win.show()
    sys.exit(app.exec_())

3. 关键注意事项 #

• 模态vs非模态窗口：如果某个窗口需要用户必须处理完才能回到主界面（比如确认弹窗），用exec_()打开模态窗口；如果可以同时操作多个窗口，用show()打开非模态窗口。
• 耗时算法要放子线程：优化算法一般耗时较长，直接在UI线程运行会导致界面卡顿，一定要用QThread把算法逻辑移到子线程，通过信号槽和UI线程通信。
• 窗口实例不要被回收：如果你的窗口是在函数内部创建的临时变量，函数执行完后会被Python的GC回收，窗口会突然消失，所以一定要把窗口实例存到全局变量或者类的属性里（比如上面的WindowManager）。

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