Qt中出现qt : undefined reference to `vtable forXXX解决办法

最新推荐文章于 2025-09-11 04:49:19 发布

原创最新推荐文章于 2025-09-11 04:49:19 发布 · 1k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#qt #class #c++ #undefined-reference-to-头文件包含正确 #宏

Qt 同时被 3 个专栏收录

27 篇文章

订阅专栏

Linux

27 篇文章

订阅专栏

CC++

19 篇文章

订阅专栏

本文介绍了在Qt中遇到的vtable错误，并提供了两种简单有效的解决方法：一是修改.pro文件，通过添加空格或换行符来触发MakeFile的重新生成；二是直接删除编译目录下的Makefile文件。

我们在Qt中要使用信号和槽的时候必须要添加Q_OBJECT宏，否则会报错。但是有时候我们添加了Q_OBJECT的时候，我们会发现同样会报错，报错如下所示：

undefined reference to 'vtable for ***(类）

面对这个报错，搞了很久了，反复检查了自己的类和头文件，发现完全没有问题呀。后来在网上搜索了一下答案，网上的方法有很多，我总结出来了两点最简单的。

一、修改.pro文件
这是最简单的一种，直接在.pro文件中，打个空格或者换行符再保存编译就行了。目的让Qt重新生成MakeFile文件。修改完成后，编译发现没有报错了。

二、直接去编译目录删除Makefile文件。

就这样就可以了，非常简单的解决办法。

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

遥_望

关注关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

【Qt问题】解决error: undefined reference to `vtable for（亲测有效）

Fanjufei的博客

02-27

2437

信号与槽之间可以进行通信的根本原因是：当在类的头文件中添加Q_OBJECT以后QtCreator会自动的创建一个moc_***.cpp文件，用于实现信号与槽通信的代码。但是，有时当我们通过QtCreator创建类的时候，没有通过IDE选项选择其派生自QObject类，而是在后面添加的，则会出现QtCreator没有自动创建moc_***.cpp文件的情况。这种情况下就会报错 : undefined reference to `vtable for ***

qt 编译时undefined reference to ‘vtable for错误

jinming868的专栏

05-03

691

undefined reference to 'vtable for

参与评论您还未登录，请先登录后发表或查看评论

VSCode C/C++扩展中"undefined reference to `WinMain`"错误分析与解决方案

最新发布

gitblog_00785的博客

09-11

555

在使用VSCode的C/C++扩展进行开发时，开发者可能会遇到"undefined reference to `WinMain`"的编译错误。这个错误通常发生在Windows平台下编译控制台应用程序时，编译器无法找到程序的入口函数。 ## 根本原因该错误的本质原因是编译器在链接阶段无法找到符合要求的程序入口点。在Windows环境下，控制台应用程序需要明确的`main`函数作为入口，而编译器默...

QT基础入门【QT错误处理】error: undefined reference to `vtable for的解决方法

吻等离子的博客

11-22

2471

根本原因是，只点击运行，不会编译新添加的宏Q_OBJECT。因此在这之前要执行“重新构建”，让moc编译器去预编译Q_OBJECT，然后再运行，就不再报错了。导致错误信息的原因是：子类没有实现父类的。宏，然后直接运行，都会造成这个错误。实际原因可能是在Qt中一个类中添加了。首先执行“重新构建”，然后再运行。

QT出现“undefined reference to `vtable for’”问题的原因及解决方法

会飞的石头

03-21

9137

转自：https://blog.youkuaiyun.com/qinpanke/article/details/8066397 QT通过信号与槽机制来实现通信的功能。当该类派生自QObject并且在头文件中添加Q_OBJECT宏以后，就可以使用信号与槽。信号与槽之间可以进行通信的根本原因是：当在类的头文件中添加Q_OBJECT以后QtCreator会自动的创建一个moc_***.c...

QT中的 undefined reference to vtable for "xxx::xxx" 错误解决

weixin_34198453的博客

10-24

268

QT应用程序在link的时候提示undefined reference to vtable for "xxx::xxx"，第一次遇到这个错误的时候还以为是虚函数使用出的问题，当然如果虚函数使用不当，比如在某个实现类中只有声明没有定义，也会报类似的错误。实际上QT中的这种错误很可能是由于在该类中使用了Q_OBJECT宏的缘故，当把出错的类中的Q_OBJECT注释掉，编译链接...

解决Qt报“undefined reference to vtable for“错误

sanqima的专栏

08-27

886

今天在Qt工程里添加一个新类OneFunc，点击Qt工具栏的[构建项目]菜单栏时，弹出"undefined reference to vtable for OneFunc"错误。这里以OneFunc新类，添加到Qt工程HelloDesk为例，进行说明。出现该问题的原因，主要有4种: a)该新类没有添加到工程的.pro文件里; b)该新类含有Q_OBJECT宏，没有执行qmake命令； c)该新类的析构函数，缺少virtual关键字修饰; d)该新类的ui, 缺少.moc文件，需要重新moc一下；

【Qt】error: undefined reference to `vtable for MainWindow‘

郭老二

01-24

4012

1、问题描述在写一个demo时，想尽量简单，就把MainWindow类的定义和实现都写在main.cpp中，结果编译时报错： main.cpp:-1: error: undefined reference to `vtable for MainWindow' :-1: error: collect2.exe: error: ld returned 1 exit status 2、原因分析错误信息vtable 表示子类没有把父类的纯虚函数全部重新实现。一般我们会把MainWindow的定义和实现分别写

Qt5 undefined reference to `vtable for View‘解决办法：moc文件包含

有问题或资源连接有缺失的可以私信公众号新潮看世界获取

01-19

1190

有时候，我们图省事，就在main.cpp中直接放上一个类的定义，然后再main函数中直接调用，最后就会出现这样的错误： main.cpp???? error: undefined reference to `vtable for xxx类名’ 这个错误的意思就是未定义的某个类的虚表，什么是虚表，我就不详细说了，简单的说就是Qt会将头文件和cpp文件中出现的类记录在一个list表中，这个表是个结构体表，大家可以自己去看看你们的那些个build过程中的moc文件，你在cpp文件中对类的定义，调用都会记录到这个表

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

发呆的程序猿

07-06

945

原文链接:Qt经典出错信息之undefined reference to `vtable for classname 这个出错信息太常见了，用过Qt两个月以上的朋友基本上都能自己解决了，因为太经典了，可以给新手参考。出错信息一般类似:undefined reference to vtable for classname MyWidget 在执行make命令后出现。出错原因是在定义类的时候为了能使用signals和slot,在类定义的后面加了Q_OBJECT引起。因为Q_OBJECT是一个宏，在不同的类

【ROS2】编译Qt实现的库，然后链接该库时，报错：/usr/bin/ld: XXX undefined reference to `vtable for

郭老二

05-15

464

在ROS2工程中编译使用Qt实现的库时，可能会遇到未定义信号函数的链接错误，原因是CMakeLists.txt未正确配置元编译（moc）处理。解决方法包括启用Qt相关编译器（如CMAKE_AUTOMOC），确保头文件和源文件被正确添加到编译列表中，并使用qt5_wrap_cpp手动指定需要moc处理的头文件。此外，检查生成的moc文件是否存在，并确保在编译命令中启用详细输出以验证moc是否执行。其他可能的原因包括缺少必要的Qt宏（如Q_OBJECT）或CMake缓存未清空，建议删除build和install

Qt undefined reference to `vtable for * * * '

Pou光明的博客

04-21

501

点击上方蓝字可直接关注！方便下次阅读。如果对你有帮助，麻烦点个在看或点个赞，感谢~缘起：最近想写个demo验证Qt connect在第五个参数不同的情况下，各自槽函数运行在哪个线程中。...

Qt中，关于undefined reference to ‘vtable for ‘的错误

weixin_46060711的博客

01-02

513

在Qt中通过信号与槽机制来实现不同对话框，或者是不同窗口中的控件之间的信息通信。

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

u_topian的专栏

04-25

747

/自定义信号函数signals://Q_OBJECT 是一个宏，添加它才能正常使用Qt的信号和槽机制Q_OBJECT//自定义信号函数signals:public://发射信号的函数//自定义槽函数qDebug()<<"执行recSlot()成员函数，输出"<<mess1<<" "<<mess2;public:删除项目的build目录，然后重新编译；或者将main.h文件从项目中排除，然后再重新加载进来，也可以解决。

Qt报错：undefined reference to xxxxx

a1367666195的博客

08-05

5450

对于`undefined reference to xxxxx`，目前碰到了两种情况 1. pro文件里的ffmpeg路径不对 2. 头文件使用了C语言写法，但没加`extern "C"{}`

Qt 编译出错“undefined reference to `vtable for”

Peace

06-06

343

1. 有时，如果将某个类改为继承自QObject类（以前不继承自该类），编译时会出错。解决： clean Project, run qmake, rebulid都运行一遍，好了！深层原因：等你评论！...

Qt中undefined reference to报错的三种可能性和解决方法(以libgdal为例)

热门推荐

顺其自然~专栏

04-25

1万+

问题是很好解决的，就是把缺的依赖再给他装上去就好了，特别提醒一下，别的依赖都好找，直接sudo apt install XXXXX多试几回，基本也就找到了，这其中有两个库不是很好找，libmfhdfalt和libdfalt，这两个库需要安装libhdf4-alt-dev来解决。用C++写代码的都知道，在C++中，代码是分为声明和定义的，声明就是告诉编译器有这个函数，换言之，就是个名字，而定义，就是具体这个函数的实现内容。好吧，首先我能保证的是，有之前调试代码过程中，这些报错一定是没有出现的。

Qt 报错undefined reference to `vtable for' xxx

yulaker的博客

01-16

295

今天编写Qt程序时，新建一个线程类，用到信号与槽，开始的时候没有在类头文件添加Q_OBJECT就构建程序，报错。然后添加上Q_OBJECT后依然报错：undefined reference to `vtable for'和 undefined reference 'xxx'，这个xxx全是类信号，在Qtcreator里清除构建并重新构建后，依然错误，最后的解决办法：去构建目录（）将所有生成文件全

【Qt】报错error: undefined reference to `vtable for的最简单解决

weixin_68122199的博客

11-15

1597

qt的一些开发报错

QT：error: undefined reference to 'xxxx'错误提示，解决方式

06-17

### 解决方案在解决 `undefined reference to 'xxxx'` 错误时，需要从多个角度分析问题的来源。以下是可能的原因及对应的解决方案： #### 1. **Q_OBJECT 宏未正确使用** 如果错误涉及类中定义了信号或槽函数，但编译时出现 `undefined reference to vtable for xxx`，可能是由于类头文件中未正确使用 `Q_OBJECT` 宏[^2]。确保以下几点： - 确认类头文件中包含 `#include <QObject>`。 - 在类声明中添加 `Q_OBJECT` 宏。 - 如果修改了头文件，重新运行 `qmake` 以生成新的 Makefile。示例代码： ```cpp #include <QObject> class MyClass : public QObject { Q_OBJECT public: MyClass(QObject *parent = nullptr); signals: void entered(); }; ``` #### 2. **moc 文件未正确生成** 如果类中使用了 `Q_OBJECT` 宏，但 `moc` 工具未正确处理头文件，也可能导致链接错误。可以手动检查 `moc` 是否生成了相应的 `.moc` 文件。如果未生成，尝试以下方法： - 清理项目并重新构建：`Build > Clean All` 和 `Build > Rebuild All`。 - 手动运行 `moc` 命令生成 `.moc` 文件，并将其包含到源文件中。示例命令： ```bash moc myclass.h -o moc_myclass.cpp ``` #### 3. **函数定义缺失** 如果错误提示 `undefined reference to xxx::entered()`，说明编译器找到了函数声明，但未找到其定义[^3]。检查以下内容： - 确保函数定义存在于 `.cpp` 文件中。 - 如果函数为纯虚函数，确认子类中是否实现了该函数。示例代码： ```cpp // 头文件声明 class MyClass { public: virtual void entered() = 0; // 纯虚函数 }; // 子类实现 class MyDerivedClass : public MyClass { public: void entered() override { /* 实现逻辑 */ } }; ``` #### 4. **链接库缺失** 如果错误涉及外部库中的函数，可能是链接阶段缺少必要的库文件[^3]。检查以下内容： - 确保 `pro` 文件中包含正确的模块和库路径。 - 如果使用了第三方库，确认链接选项是否正确配置。示例 `pro` 文件配置： ```pro QT += core gui LIBS += -L/path/to/library -lmylibrary ``` #### 5. **调试工具辅助** 如果上述方法均无法解决问题，可以借助调试工具进一步定位问题所在[^4]。例如： - 使用断言检查指针是否为空。 - 启用 Qt Creator 的调试模式，跟踪程序执行过程。示例代码： ```cpp #include <cassert> void foo(int* ptr) { assert(ptr != nullptr); // 检查指针是否为空 // 其他代码逻辑 } ``` --- ###