PyQt5：主窗口按钮打开子窗口时意外触发文件对话框问题

问题场景 #

• 主窗口（QMainWindow）包含按钮，点击后打开第二个QWidget窗口
• 第二个窗口使用自定义BrowseFile组件，该组件需包含Browse按钮、QLabel和QLineEdit，用于选择并显示文件路径
• 异常现象：点击主窗口按钮打开第二个窗口时，QFileDialog会直接弹出，而非点击Browse按钮时才触发

错误根源 #

在BrowseFile类的初始化方法中，按钮点击信号绑定错误：

# 错误写法：带括号会立即执行open_dialog方法
self.browse_button.clicked.connect(self.open_dialog())

此处带括号的self.open_dialog()会在BrowseFile实例化时直接调用方法，导致文件选择框提前弹出。正确的绑定方式是传递方法引用（不带括号），让信号触发时才调用方法。

修正后的完整代码 #

from PyQt5.QtWidgets import (QApplication, QMainWindow, QWidget, QHBoxLayout, 
                             QGridLayout, QFileDialog, QPushButton, QLabel, QLineEdit)

class BrowseFile(QWidget):
    def __init__(self):
        super(BrowseFile,self).__init__()        
        
        self.layout = QHBoxLayout()
        self.setLayout(self.layout)
        
        # 补充需求中的QLabel和QLineEdit
        self.label = QLabel("文件路径：", self)
        self.line_edit = QLineEdit(self)
        self.line_edit.setReadOnly(True)  # 设置为只读，避免手动编辑
        
        self.browse_button = QPushButton("Browse", self)
        # 修正：传递方法引用，不带括号
        self.browse_button.clicked.connect(self.open_dialog)

        self.layout.addWidget(self.label)
        self.layout.addWidget(self.line_edit)
        self.layout.addWidget(self.browse_button)
        
    def open_dialog(self):
        # 获取选中文件路径，并更新到QLineEdit
        file_path, _ = QFileDialog.getOpenFileName(self, "选择文件")
        if file_path:
            self.line_edit.setText(file_path)

class SecondWindow(QWidget):
    def __init__(self):
        super(SecondWindow,self).__init__()
                
        self.layout = QGridLayout()
        
        self.browse_file = BrowseFile()
        self.layout.addWidget(self.browse_file, 0, 0, 1, 2)  # 调整布局占列，适配组件
                
        self.setLayout(self.layout)    
        self.resize(600, 100)  # 设置窗口初始大小

class MainWindow(QMainWindow):
    def __init__(self):
        super(MainWindow,self).__init__()
        
        self.button = QPushButton(self, text="打开文件选择窗口")
        self.button.clicked.connect(self.button_click)
        self.setCentralWidget(self.button)
        self.resize(300, 100)
               
    def button_click(self):
        self.second_window = SecondWindow()
        self.second_window.show()

###############
app = QApplication([])

main_window = MainWindow()
main_window.show()

app.exec()

关键说明 #

1. 信号与槽的正确绑定：PyQt中信号绑定槽函数时，必须传递方法的引用（即方法名不带括号），如果带括号会立即执行该方法，而非等待信号触发。
2. 完整组件实现：按照需求添加了QLabel和只读的QLineEdit，选中文件后自动更新路径显示，符合最初的组件设计需求。

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