Qt编译出错：undefined reference to `vtable for XXX‘

最新推荐文章于 2025-03-11 11:53:33 发布

u_topian

最新推荐文章于 2025-03-11 11:53:33 发布

阅读量557

点赞数 3

文章标签： qt 开发语言 c++

本文链接：https://blog.youkuaiyun.com/u_topian/article/details/130357454

版权

文章讲述了在Qt编程中，如果自定义类想要使用信号槽机制，必须继承自QObject并包含Q_OBJECT宏。否则，编译时会出现未定义引用到vtable的错误。解决方案是删除build目录后重新编译，或排除并重新加载头文件，以确保Qt能生成moc_XXX.cpp文件。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在一个已经编译过的项目中添加了一个自定义类，自定义类在main.h头文件中，而且未继承QObject也没有添加Q_OBJECT宏：

#ifndef MAIN_H
#define MAIN_H

class MyWidget
{ 
    //自定义信号函数
signals:
    void MySignal(QString mess1,QString mess2);
};
#endif // MAIN_H

若想使用Qt的信号槽通信机制，则需要让自定义类继承自QObject类，并在头文件中添加Q_OBJECT宏：

#ifndef MAIN_H
#define MAIN_H

#include<QObject>
#include<QDebug>
#include<QString>

class MyWidget:public QObject
{
    //Q_OBJECT 是一个宏，添加它才能正常使用Qt的信号和槽机制
   Q_OBJECT
    //自定义信号函数
signals:
    void MySignal(QString mess1,QString mess2);
public:
    //发射信号的函数
    void emitSignal(){
        emit MySignal(message1,message2);
    }
    //自定义槽函数
public slots:
    void recSlot(QString mess1,QString mess2){
        qDebug()<<"执行recSlot()成员函数，输出"<<mess1<<" "<<mess2;
    }
public:
    QString message1;
    QString message2;
};
#endif // MAIN_H

此时编译报错：

undefined reference to `vtable for MySignalSlot'

解决方法：

删除项目的build目录，然后重新编译；或者将main.h文件从项目中排除，然后再重新加载进来，也可以解决。

原因：

当通过Qt这个IDE创建新类中添加QObject头文件和Q_OBJECT后，Qt会生成相应的“moc_XXX.cpp”文件，用于信号槽的通信实现。但是若在创建类时没有通过Qt添加QObject头文件和Q_OBJECT，Qt无法生成相应的“moc_XXX.cpp”文件，此时就会报错：undefined reference to `vtable for XXX',如上面例子。
————————————————
版权声明：本文为优快云博主「TanChengkai」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.youkuaiyun.com/TanChengkai/article/details/102466498