PyQt5窗口点击最大化按钮后消失且无法最大化的问题排查

问题原因 #

1. 多次调用setWindowFlags()引发标志异常：每次调用setWindowFlags()会重新应用窗口标志，尽管使用了按位或操作，但在Ubuntu窗口管理器环境下，多次修改会导致窗口装饰组件状态异常，出现按钮消失、功能失效的问题。
2. QWidget默认窗口标志不完整：你的MainWindow继承自QWidget，而QWidget默认窗口标志为Qt.Widget，属于无框架部件样式，没有完整的顶层窗口装饰支持，直接添加最大化/最小化按钮会引发交互逻辑异常。

修复方案 #

将窗口标志设置合并为一次调用，同时明确指定顶层窗口标志Qt.Window，确保窗口拥有完整的装饰组件：

class MainWindow(QtWidgets.QWidget):
    def __init__(self, *args, **kwargs) -> None:
        super(MainWindow, self).__init__(*args, **kwargs)
        self.setWindowTitle("Speech To Text")
        # 一次性设置所有所需窗口标志，包含顶层窗口属性及按钮提示
        self.setWindowFlags(Qt.Window | Qt.WindowMaximizeButtonHint | Qt.WindowCloseButtonHint | Qt.WindowMinimizeButtonHint)

        # 以下布局代码保持不变
        self.app_name = QtWidgets.QLabel("Speech To Text")
        self.hbox = QtWidgets.QHBoxLayout()
        self.someButton1 = QtWidgets.QPushButton("btn1")
        self.someButton2 = QtWidgets.QPushButton("btn2")
        self.hbox.addWidget(self.someButton1)
        self.hbox.addWidget(self.someButton2)

        self.grid = QtWidgets.QGridLayout()
        self.vbox = QtWidgets.QVBoxLayout()
        
        self.topBtn1 = QtWidgets.QPushButton("Top Button 1")
        self.topBtn2 = QtWidgets.QPushButton("Top Button 2")
        self.topLayout = QtWidgets.QVBoxLayout()
        self.topLayout.addWidget(self.topBtn1)
        self.topLayout.addWidget(self.topBtn2)

        self.startButton = QtWidgets.QPushButton()
        self.startLabel = QtWidgets.QLabel()
        self.startLabel.setText("Tap To Record")
        self.startLayout = QtWidgets.QVBoxLayout()
        self.startLayout.addWidget(self.startButton, alignment=Qt.AlignCenter)
        self.startLayout.addWidget(self.startLabel, alignment=Qt.AlignCenter)        
        self.startLayout.addStretch()

        self.stopButton = QtWidgets.QPushButton()
        self.stopLabel = QtWidgets.QLabel()
        self.stopLabel.setText("Stop")
        self.stopLayout = QtWidgets.QHBoxLayout()
        self.stopLayout.addWidget(self.stopButton)
        self.stopLayout.addWidget(self.stopLabel)

        self.vbox.addLayout(self.topLayout)
        self.vbox.addLayout(self.startLayout)
        self.vbox.addLayout(self.stopLayout)
        self.vbox.addWidget(self.app_name, alignment=Qt.AlignCenter, stretch=1)
        
        self.editor = QtWidgets.QTextEdit()

        self.grid.addLayout(self.hbox, 0, 2)
        self.grid.addLayout(self.vbox, 1, 1)
        self.grid.addWidget(self.editor, 1, 2)
        self.setLayout(self.grid)

补充说明 #

• 若需保留原窗口的默认标志（如模态属性），可将原标志与新标志合并，但必须确保包含Qt.Window：

  self.setWindowFlags(self.windowFlags() | Qt.Window | Qt.WindowMaximizeButtonHint | Qt.WindowCloseButtonHint | Qt.WindowMinimizeButtonHint)
  

• 若无需自定义窗口框架，可将MainWindow改为继承QMainWindow，其默认自带完整的顶层窗口标志，无需额外设置即可支持最大化/最小化按钮。

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