Qt经典出错信息之undefined reference to `vtable for classname

Posted 2020-08-23 行尸走肉

原文链接:Qt经典出错信息之undefined reference to `vtable for classname

这个出错信息太常见了，用过Qt两个月以上的朋友基本上都能自己解决了，因为太经典了，可以给新手参考。

出错信息一般类似:undefined reference to `vtable for classname MyWidget`
在执行make命令后出现。

出错原因是在定义类的时候为了能使用signals和slot,在类定义的后面加了Q_OBJECT引起。 因为Q_OBJECT是一个宏，在不同的类中展开是不同的代码，例如在mywidgeth.h中生成的

public: template inline void qt_check_for_QOBJECT_macro(const T &_q_argument) const { int i = qYouForgotTheQ_OBJECT_Macro(this, &_q_argument); i = i; } static const QMetaObject staticMetaObject; virtual const QMetaObject *metaObject() const; virtual void *qt_metacast(const char *); static inline QString tr(const char *s, const char *c = 0) { return staticMetaObject.tr(s, c); } static inline QString trUtf8(const char *s, const char *c = 0) { return staticMetaObject.trUtf8(s, c); } static inline QString tr(const char *s, const char *c, int n) { return staticMetaObject.tr(s, c, n); } static inline QString trUtf8(const char *s, const char *c, int n) { return staticMetaObject.trUtf8(s, c, n); } virtual int qt_metacall(QMetaObject::Call, int, void **); private:

可以看到以上的代码声明了3个从父类继承的3个虚函数。本来这三个函数的实现应该是由moc_mywidget.cpp来完成。
而当前的错误正是因为Makefile里没有将moc_mywidget.cpp加入编译引起。

Makefile背后的原因是qmake，因为Qt的编译系统是通过qmake将.pro 文件转换成Makefile文件。当qmake扫描.h代码时发现有Q_OBJECT这样字眼的代码时，会将一个用moc生成moc_xxx.cpp代码 的依赖关系写到Makefile里。如果扫描时没有找到Q_OBJECT就不会生成额外的moc_xxx.cpp这样的文件。

出现最初一幕的原因是在执行qmake的时候.h代码里并没有O_OBJECT这样的代码。而执行make的时候.h里已经有Q_OBJECT了，解决的方法就是重新执行qmake，然后执行make.

——

shiroki：另外我再加一句， 还有一种可能性是写代码的人把所有的代码都写在了.cpp文件中。要知道moc工具只读.h文件，如果把Q_OBJECT宏放在cpp里moc是看不到的……所以大家写代码还是要遵守声明放.h实现放cpp的规矩比较好。

Q_OBJECT undefined reference to 问题  

摘自：http://waiter94.blog.163.com/blog/static/5277376920103423144138/

如果你的class的定义和身明 是放在同一cpp文件里 如: Test.cpp, 并且在class使用了slot/signal. 在这个cpp文件的最底部 加上

＃include "文件名.moc" 会帮助你除去编译的问题

 

Qt 出现“undefined reference to `vtable for”原因总结

 

由于Qt本身实现的机制所限，我们在使用Qt制作某些软件程式的时候，会碰到各种各样这样那样的问题，而且很多是很难，或根本很难找到原因的，即使解决了问题，假如有人问您为什么，您只能回答－－不知道；

今天我在这里列举的问题也是再编写Qt程式时，总是碰到的问题，问题普遍，而答案却不唯一，解 释这一个问题的说法很多，往往只适合某一种情况，因为这个错误太笼统了，他就是－－ “undefined reference to `vtable for”可能您看着很熟悉，似乎在c++程式中也碰到过这个问题，您说对了，有时候这个错误，不只是qt的原因，更有您的c++程式的原因；

下面搜集了网上的一些出现的现象，对应解决方法，原因，基本上我都验证过，收录于此，以做备份；

一：

预编译器打开宏Q_OBJECT，声明若干个由moc处理(implement)的成员函数。 假如得到类似于“undefined reference to vtable for LcdNumber”的编译错误(if you get compiler errors along the lines of "undefined reference to vtable for LcdNumber")，您可能是忘记了执行moc，或忘记了将moc输出加入到link命令里。

某一个类中假如加入Q_OBJECT后,则link时提示:undefined reference to vtable for "xxx::xxx".删掉他则没有任何问题.

解决:尝试(1):把任何的obj文档和uic文档删除,重新编译.仍然失败.

去trolltech的mail lists找到原因: 因为qmake生成Makefile的时候,这个类的头文档中并没有Q_OBJECT,所以在相应的Makefile里面并没有用moc xxx.h命令,最终导致链接失败.重新运行qmake,问题解决.

在查找解决方法的时候,附带发现一点:

qmake 不会处理.cpp文档里的Q_OBJECT,所以,假如在.cpp文档中有他的话,也会产生undefined reference to vtable for "xxx::xxx". 这时,需要先用moc xxxx.cpp生成相应的moc文档,再包含到.cpp里面去,才能解决这个问题.

这里能够发现问题的出现是因为没有moc生成相应的moc文档，之后连接就出问题。

我找了好多源码之类的问题，就是没有找pro的错误，后来想到qt中moc我们是有make做的

qt的make编译是根据Makefile来的，而Makefile是由pro文档来的。这才想到了找pro文档的错误。

from: http://www.cublog.cn/u/16292/showart_136087.html

二：

undefined reference to vtable for "xxx::xxx"

今天碰到了这个问题，终于被我google到了：

http://www.cublog.cn/opera/showart.php?blogid=8650&id=49526

原 因：qmake不会处理.cpp文档里的Q_OBJECT,所以,假如在.cpp文档中有他的话,也会产生undefined reference to vtable for "xxx::xxx". 这时,需要先用moc xxxx.cpp生成相应的moc文档,再包含到.cpp里面去,才能解决这个问题.

其他：

1.问题: QGLViewer中的函数不能正常link.解决: 翻看其源代码,发现是因为从源码安装libQGLViewer时,编译用了Qt 3,而我的程式中用Qt4 编译.所以必须重新用Qt4编译.但是,更改QTDIR 环境变量为Qt4后,重新编译的话,qmake生成makefile时就提示出错.进一步发现,是因为虽然设了QTDIR为Qt4,头文档和库文档都会使 用Qt4,但是moc,uic等都是用的qt3版的,再把PATH环境变量改变后,一切ok.

2.问题:某一个类中假如加入Q_OBJECT后, 则link时提示:undefined reference to vtable for "xxx::xxx".删掉他则没有任何问题.解决:尝试(1):把任何的obj文档和uic文档删除,重新编译.仍然失败.去trolltech的 mail lists找到原因: 因为qmake生成Makefile的时候,这个类的头文档中并没有Q_OBJECT,所以在相应的Makefile里面并没有用moc xxx.h命令,最终导致链接失败.重新运行qmake,问题解决.在查找解决方法的时候,附带发现一点:qmake 不会处理.cpp文档里的Q_OBJECT,所以,假如在.cpp文档中有他的话,也会产生undefined reference to vtable for "xxx::xxx". 这时,需要先用moc xxxx.cpp生成相应的moc文档,再包含到.cpp里面去,才能解决这个问题.

3. 看Qt的reference发现: 能够connect(pObjA, SIGNAL(someSignalA()),pObjB,SIGNAL(someSignalB()));这样pObjA发出的someSingalA 会导致pObjB发出someSignalB,从而形成信号接力.