主窗口意外生成无文本方形Widget的原因及解决方法

嘿，这个问题我之前也遇到过几次，大概率是控件创建或布局的小疏漏导致的，咱们一步步来拆解成因和解决办法：

可能的成因 #

• 冗余的空白控件实例：你可能在代码里不小心多创建了一个QPushButton（或其他Widget）实例，既没设置文本，也没把它加入布局管理。Qt默认会把未被布局约束的子控件放在窗口左上角，就形成了你看到的空白方形。
• 布局管理失误：如果主窗口的centralWidget没有设置正确的布局，或者某个控件被直接添加到主窗口而非布局中，也会出现这种游离的空白控件。比如你可能把viewEvidenceButton的父控件设为主窗口，但没将它添加到布局里，不过这种情况你的目标按钮也会乱跑，所以更可能是其他冗余控件。
• Qt Designer残留问题：如果是用设计器生成的代码，可能在设计界面时不小心拖入了空白控件，代码生成时带了过来。

解决办法 #

• 排查并删除冗余控件代码
  仔细检查主窗口的初始化代码（比如__init__方法），找一找有没有类似这样的冗余语句：

  # 多余的代码，会生成空白按钮
  QPushButton(self)
  

  找到后直接删除这行代码就行。

• 确认布局配置正确
  确保所有控件都被纳入布局管理，主窗口的centralWidget要正确绑定布局：

  # 初始化centralWidget和布局
  self.central_widget = QWidget()
  self.setCentralWidget(self.central_widget)
  self.main_layout = QVBoxLayout(self.central_widget)
  
  # 将你的按钮添加到布局中
  self.viewEvidenceButton = QPushButton("查看证据", self.central_widget)
  self.main_layout.addWidget(self.viewEvidenceButton)
  self.viewEvidenceButton.clicked.connect(self.openReportViewer)
  

  这样所有控件都会按照布局规则排列，不会出现游离的空白控件。

• 检查按钮自身的初始化
  确认viewEvidenceButton的文本设置没有遗漏，虽然这不是左上角空白控件的直接原因，但也能避免按钮本身显示异常：

  # 确保设置了按钮文本
  self.viewEvidenceButton.setText("查看证据")
  

• Qt Designer用户的额外检查
  打开对应的.ui文件，在设计界面里找一找有没有多余的空白控件，删掉后重新生成Python代码即可。

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