Qt LNK2001:无法解析的外部符号 未找到文件moc_XXX.obj

由于在运行项目的过程中遇到这个bug实在太多次,特此记录一下,方便今后遇到同样的问题时能更快地解决。

Qt LNK2001:无法解析的外部符号 未找到文件moc_XXX.obj

STEP1 检查代码

第一步肯定要先检查我们的代码是否正确,主要要关注的地方有:
① 头文件中,在类的定义里是否添加Q_OBJECT
② 类的头文件和源文件是否有缺漏
③ 在类的定义中声明的方法是否都有实现

STEP2 执行qmake

之前报这个错误的时候qmake是有效的,但这次失效了。

STEP3 手动添加moc文件

这个方法是我在网上看到的,系统提示缺少哪个类的moc文件,就在该.cpp文件中添加#include "moc_XXX(类名).cpp",虽然没有解决我这次遇到的问题,但可以作为一种尝试。

STEP4 删除项目的编译文件夹并重新编译

Qt LNK2001:无法解析的外部符号 未找到文件moc_XXX.obj
把出错的工程下的build文件夹删掉,再重新编译。
P.S:只删除debug下的.obj文件还是会报一大堆错误。

STEP5 重建大法好

网上别人给出的方法是把出错的类对应的.h文件和.cpp文件内容备份下来,并在项目中删除这两个文件,然后新建.h文件和.cpp文件,并拷贝之前备份的内容。
但是我在排查错误原因的时候,将.pri文件中出错的类的.h文件和.cpp文件注释掉后运行了一遍,取消注释再运行一遍,就不报错了,歪打正着。原理应该和上面这种方法是一样的。