Qt自定义QWidget子类无法连接内部QLineEdit信号报错解决

Search_browser继承自QWidget，类定义中没有声明returnPressed()信号，其内部封装的QLineEdit实例是私有成员，外部作用域无法直接访问，因此直接连接Search_browser实例的returnPressed()信号时，Qt元对象系统找不到对应信号，就会抛出你看到的运行时错误。

方法1：信号转发（推荐，符合封装规范） #

不需要暴露内部私有控件，只需要在自定义类中声明同名信号，在构造函数内将内部QLineEdit的信号转发为自定义类的信号即可。

1. 修改Search_browser头文件，新增信号声明：

class Search_browser : public QWidget
{
    Q_OBJECT
public:
    Search_browser(QWidget *parent = nullptr);
    ~Search_browser();
    QString get_url();

// 新增自定义信号
signals:
    void returnPressed();

public slots:
    void replyFinished(QNetworkReply *reply);
    void get_request();

private:
    QLineEdit *lineEdit;
    QCompleter *completer;
    QStringList wordList;
};

2. 在Search_browser的构造函数中，添加内部信号和自定义信号的连接：

Search_browser::Search_browser(QWidget *parent)
    : QWidget(parent)
{
    // 保留原有初始化逻辑：创建lineEdit、completer，设置布局等
    lineEdit = new QLineEdit(this);
    // ... 其余你的原有代码

    // 新增信号转发逻辑
    connect(lineEdit, &QLineEdit::returnPressed, this, &Search_browser::returnPressed);
}

修改完成后，主程序中原有连接代码不需要做任何调整，即可正常触发set_page()槽函数。

方法2：暴露内部控件指针（不推荐，破坏封装性） #

如果不想实现信号转发，可以给Search_browser添加公有接口返回内部QLineEdit的指针，外部直接持有该指针连接信号。

1. 在Search_browser头文件添加公有方法：

public:
    QLineEdit* editableLine() { return lineEdit; }

2. 修改主程序中的连接代码：

search = new Search_browser(ui->widget);
// 老式宏写法
connect(search->editableLine(), SIGNAL(returnPressed()), this, SLOT(set_page()));
// 推荐使用Qt5+新式函数指针写法，编译期即可校验信号槽有效性，避免运行时错误
// connect(search->editableLine(), &QLineEdit::returnPressed, this, &MainWindow::set_page);

注意：该方法会将内部私有控件的控制权暴露给外部，外部代码可以任意修改控件属性、拦截事件，违背封装原则，非特殊场景不建议使用。

日常开发优先使用Qt5引入的新式connect语法，不需要手动书写SIGNAL/SLOT宏，信号、槽不存在或者参数不匹配时会在编译阶段直接报错，能提前规避大量运行时信号连接问题。

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