用Qt Creator向导添加新类（class）后报错LNK2019无法解析的外部符号

最新推荐文章于 2025-06-06 15:14:04 发布
原创 最新推荐文章于 2025-06-06 15:14:04 发布 · 2.4k 阅读 · 3 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#qt #类 #无法解析的外部符号

本文介绍了解决在添加新类后出现的LNK2019未解析外部符号错误的方法。即使使用之前能正常编译的类也会报错，解决方式是删除调试文件夹并重新运行。

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

在添加了一个新的class之后就报这个错，查了好久没发现代码的问题，甚至把原来能编译通过的class 直接copy过来都还是报错，

main.obj:-1: error: LNK2019: 无法解析的外部符号 "public: __cdecl MySmallWidget::MySmallWidget(class QWidget *)" (??0MySmallWidget@@QEAA@PEAVQWidget@@@Z)，该符号在函数 main 中被引用

最终找到的解决办法就是删掉调试文件夹重新运行就好了，另外有时候新添加的图标不显示也是这个问题。

（遇到这样的问题，先确定代码没问题，或者写一个最简单的测试程序，如果代码没问题那就不要死钻到里面折腾了，一定是哪里出了什么问题，不要盲目瞎折腾。）

Qt飞机大战【手把手教程】
178技术
04-20 7057
本文较长，建议收藏，可以观看本文配套视频教程【C++干大事系列之游戏篇：Qt飞机大战】 1、项目简介 飞机大战是我们大家所熟知的一款小游戏，本教程就是教大家如何制作一款自己的飞机大战。 首先我们看一下效果图 转存失败重新上传取消 玩家控制一架小飞机，然后自动发射子弹，如果子弹打到了飞下来的敌机，则射杀敌机，并且有爆炸的特效。接下来再说明一下案例的需求，也就是我们需要实现的内容。 ...
Qt 开发需要知道的几个常用的语法（读书学习笔记）
大象身边的小蚂蚁
08-16 1835
程序的打包发布 利用Qt Creator自带的windeployqt 工具，是非常的方便的， 只要新建一个testname，将release版本的可执行文件xxx.exe放到这个新建文件夹testname中， 然后打开在开始菜单—>Qt 5.3—>MinGW 4.8 (32-bit)—>Qt 5.3 for Desktop (MinGW 4.8 32 bit)的命令窗口： ...
error LNK2019: 无法解析的外部符号 问题的解决办法
09-05
error LNK2019: 无法解析的外部符号 问题的解决办法，需要的朋友可以参考一下
【问题处理】widget.obj:-1: error: LNK2019: 无法解析的外部符号 “__declspec(dllimport) pub
AY的博客
03-25 853
解决方案：出现这样的错误一般是声明了函数没有实现其定义，比如这里提示的是没有自定义类MyWidget的实现函数。如果你已经检查了确定定义是有的，比如我这个就确实有定义了的，那就把该项目编译出的build debug文件夹给删除掉，再重新编译，注意是编译出来的整个文件夹一起删，而不是clean清除后重新构建。
【Qt】:设置新建类模板
最新发布
weixin_44322778的博客
06-06 435
需要我帮你创建对应的.cpp文件模板吗？或者对模板有其他定制需求？
widget.obj:-1: error: LNK2019: 无法解析的外部符号 “void __cdecl cv::error(int,class std::basic_string＜char,st
qq_52218412的博客
05-16 590
图像处理OpenCV，报错LNK2019：无法解析的外部符号 【1】下载并安装OpenCV，配置OpenCV环境变量 【2】在.pro工程文件中加入OpenCV库路径和库文件名 【3】添加头文件和命名空间 【4】运行项目，检验是否配置成功。
【QT】widget.obj:-1: error: LNK2019: 无法解析的外部符号 __imp_PostMessageW，函数 “private: void __cdecl Widget
胡先森i的博客
11-14 1万+
问题： 我在QT学习的过程中，遇到一个非常棘手的问题，简单而又复杂。网上找到一堆什么删除Debug下的文件夹再重新构建，屁用没有。在几番百度谷歌搜索下，终于找到一个解决办法，在此非常感谢前辈大佬的笔记，真的有用。先简单描述一下问题：编译后报错，以下几个，看的我是头疼不已！ error: LNK2019: 无法解析的外部符号 __imp_PostMessageW，函数 "private: void __cdecl Widget::refresh(struct HWND__ *)" (?refresh@Widg
QT error: LNK2019: 无法解析的外部符号 __imp__SendMessageW@ 类型的错误 以及 pragma comment 的作用（用法）
热门推荐
漫步繁华街的专栏
08-18 3万+
使用QT Creator 开发一个通讯项目时候，需要使用windows系统函数，比如： #include <windows.h> #include <WinUser.h> ... ::IsWindow(server) ::FindWindowW(nullptr,title); ::SendMessage(server, WM_COPYDATA, reinterpret_cast<WPARAM>(sender), reinterpret_cast<LPAR
Qt5.9.1进阶打包技巧：如何构建定制化安装包（专业指导）
随后，文章详细介绍了使用Qt Maintenance Tool和手动创建安装包的具体步骤，包括环境配置、元数据设置和安装脚本编写。进一步地，本文揭示了打包过程中的高级技巧，包括优化安装包大小、处理国际化/本地化以及集成第...
Qt6打包技巧大揭秘：让exe跨多环境无障碍运行
![Qt6打包技巧大揭秘：让exe跨多环境无障碍运行](https://higfxback.github.io/wl-qtwebkit.png) # 1....Qt6打包的基本原理是将应用程序与Qt运行时、第三方库等依赖包整合，并针对目标平台进行配置
【Qt_MSVS环境搭建实战】：案例分析与解决方案
首先，介绍了Qt和MSVS环境的搭建过程，包括Qt的下载安装、环境变量配置以及MSVS的安装与集成。接着，本文阐述了Qt项目结构、创建及编译流程，强调了项目文件(.pro)的重要性及其常用设置项。在高级话
Qt Creator编译出现 error LNK2019: 无法解析的外部符号 无法找到某个obj文件
NcepuKZH的博客
03-04 1876
QT Creator 出现此类错误一般都是因为pro文件格式问题： 切记不能混用 以上两种形式都是可以加载头文件的
Qt Creator5.4中出现error LNK2019 无法解析的外部符号的解决办法
析万物之理的专栏
10-16 1184
在使用Qt Creator建立工程之后，又新建了一个新的类（about类），类的声明在about.h中，但在编译链接时，链接时找不到MainWindow.obj，经过在网上一翻查找，查到解决方案如下： 将当前工程所在父目录下的bulid-(工程名)-Desktop-Qt-5-4-MSVC2010-32bit-（Debug/Release）文件夹删除，若是在Debug状态下，则删除Debug文件夹，若
Qt creator 编译错误：无法解析的外部符号（命令）
hyqsong的专栏
07-26 1万+
问题来自于：只是在creator 中添加了一个新的DIalog类，并在main()，中实例化并show，就出现如下的错误： main.obj:-1: error: LNK2019: 无法解析的外部符号 "public: __cdecl Dialog::Dialog(class QWidget *)" (??0Dialog@@QEAA@PEAVQWidget@@@Z)，该符号在函数 main
main.obj:-1: error: LNK2019: 无法解析的外部符号 "public: __thiscall CFindFileForm::CFindFileForm(class QWidge
SuperWe的博客
12-03 5868
qt5中运行时出现这个问题，起因是自己新建了一个类在.h文件中，在main.cpp中include了，链接时候出了问题，解决办法，删掉debug和release文件夹，删掉makefile，重新编译。
Qt5.12无法解析的外部命令
qq_43769747的博客
09-25 798
Qt5.12版本，MSVC201764位编译环境下，在组件中使用“提升法”修改组件类后遇到一个问题： **mainwindow.obj???? error: LNK2019: 无法解析的外部符号 "public: __cdecl QmyVideoWidget::QmyVideoWidget(class QWidget )" (??0QmyVideoWidget@@QEAA@PEAVQWidget@@@Z)，函数 "public: void __cdecl Ui_MainWindow::setupUi(cla
Qt 问题:无法解析的外部符号
weixin_30474613的博客
09-09 1080
1.在.pro文件中已经加入依赖项后，头文件可通过提示正常include,运行出现： main.obj:-1: error: LNK2019: 无法解析的外部符号 "public: __cdecl Dialog::Dialog(class QWidget *)" (??0Dialog@@QEAA@PEAVQWidget@@@Z)，该符号在函数 main 中被引用 main.obj:-1: er...
qt main.obj:-1: error: LNK2019: 无法解析的外部符号 __imp_CommandLineToArgvW，该符号在函数 “int __cdecl dumpMacros(wc
qiushangren的专栏
09-28 1948
qt 系统库路径配置
qt在类中添加Q_OBJECT宏，报错无法解析的外部符号
03-20
<think>好的，用户遇到了在Qt类中添加Q_OBJECT宏后出现“无法解析的外部符号”错误的问题。我需要详细分析可能的原因和解决方案。首先，这个错误通常与Qt的元对象编译器（moc）没有正确处理包含Q_OBJECT宏的头文件有关。 用户可能是在添加Q_OBJECT宏后没有重新生成moc文件，导致链接器找不到相应的元对象代码。这时候需要检查构建步骤，确保moc处理了相关的头文件。如果使用qmake，需要运行qmake来更新Makefile，然后重新构建。对于CMake项目，需要确保AUTOMOC被正确启用。 另一个可能的原因是头文件没有被正确包含在项目文件中，比如.pro文件中的HEADERS部分遗漏了相应的头文件。用户可能没有将类声明在正确的头文件中，或者文件名拼写错误。 还有可能是构建目录中存在旧的moc文件残留，导致冲突。这时候需要清理构建目录，然后重新构建。 此外，用户可能在派生类中使用Q_OBJECT时，基类不是QObject的子类，或者没有在基类中添加Q_OBJECT宏。需要确保所有使用信号槽的类都正确继承自QObject及其派生类，并正确使用宏。 最后，如果用户没有在项目中正确链接QtCore等必要的模块，也可能导致链接错误。需要检查.pro文件中的QT配置是否包含core等模块。 总结下来，可能的解决步骤包括：清理并重新构建项目，确保moc处理了相关文件，检查项目配置，验证继承关系和模块链接。需要逐步引导用户检查这些方面，以解决外部符号错误的问题。</think>在Qt开发中，当你在类中添加`Q_OBJECT`宏后出现“无法解析的外部符号”错误（如`unresolved external symbol "vtable for MyClass"`），通常是因为**未正确生成元对象代码（Meta-Object Code）**。以下是逐步排查和解决方案： --- ### **问题原因** `Q_OBJECT`宏用于启用Qt的**信号槽机制**和**元对象系统**。添加该宏后，Qt需要通过**moc（Meta-Object Compiler）**预处理器生成额外的C++代码（如`moc_*.cpp`文件）。若构建流程未正确处理，会导致链接器找不到这些生成的代码。 --- ### **解决方案** #### **步骤1：清理并重新构建项目** - **手动触发moc**：删除构建目录（如`build/`或`release/`），重新运行构建命令（如`qmake && make`）。 - **IDE操作**：在Qt Creator中点击菜单栏的**Build → Rebuild Project**。 #### **步骤2：检查项目配置** - **qmake项目（.pro文件）**： ```makefile # 确保头文件被包含在HEADERS中 HEADERS += MyClass.h # 确保启用Qt核心模块 QT += core ``` - **CMake项目**： ```cmake # 启用AUTOMOC（自动调用moc） set(CMAKE_AUTOMOC ON) # 添加Qt模块 find_package(Qt6 COMPONENTS Core REQUIRED) ``` #### **步骤3：验证类定义** 确保类满足以下条件： 1. **继承自`QObject`**（直接或间接）： ```cpp class MyClass : public QObject { Q_OBJECT // ... }; ``` 2. **头文件未被误标记为纯C++文件**：在Qt项目中，头文件应添加到`HEADERS`而非`SOURCES`。 #### **步骤4：检查编译输出** 查看构建日志，确认`moc`是否生成了对应的`moc_*.cpp`文件。若未生成，可能是： - **文件名拼写错误**：`moc`工具默认处理`*.h`头文件。 - **宏位置错误**：`Q_OBJECT`必须放在类定义的**第一个私有部分**。 #### **步骤5：处理多级继承** 若类继承自模板类（如`QWidget`），确保父类已正确包含： ```cpp #include <QWidget> class MyClass : public QWidget { Q_OBJECT // ... }; ``` --- ### **常见错误示例** #### **错误代码** ```cpp // MyClass.h class MyClass { // 未继承QObject！ Q_OBJECT // 错误：缺少基类QObject public: MyClass(); }; ``` #### **修正代码** ```cpp // MyClass.h #include <QObject> class MyClass : public QObject { Q_OBJECT // 正确：继承QObject public: MyClass(); }; ``` --- ### **高级场景** #### **静态库中的Q_OBJECT** 若类位于静态库中，需在库的`.pro`文件中添加： ```makefile CONFIG += staticlib QT += core ``` #### **PIMPL模式** 若使用PIMPL（指针封装实现），需将`Q_OBJECT`放在**公有类**中，而非实现类。 --- ### **总结** - **核心原则**：Qt的`moc`必须正确处理包含`Q_OBJECT`的头文件。 - **检查顺序**：清理构建 → 验证继承 → 检查配置 → 确认moc生成。 - **关键命令**：`qmake`、`cmake --build`、`make clean`。 通过以上步骤，可彻底解决因`Q_OBJECT`宏导致的外部符号错误。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值