Qt报错：无法解析外部命令，解决办法

已于 2022-04-15 21:18:44 修改
阅读量3k 收藏 1
点赞数 2
CC 4.0 BY-SA版权
分类专栏： Qt开发教程 文章标签： bug qt5
于 2020-04-17 09:50:26 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/kangjielearning/article/details/105573407
本文介绍了Qt编程时遇到的LNK2019错误，即无法解析的外部符号问题。作者作为Qt新手，在自定义按钮后遇到了该错误。解决方法包括删除Debug目录中的所有文件，然后通过Qt Creator的qmake重新构建项目，成功解决了问题。

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

是这样的，我是一个Qt小白，昨晚就简简单单自定义了一个按钮，就出现下面的问题。
**widget.obj : error LNK2019: 无法解析的外部符号 "public: __cdecl MyPushButton…**具体错误提示很长来着，，，
直接上解决办法吧：
第一步：
删掉工程文件目录中Debug中的所有文档。
在这里插入图片描述
第二步：
点击，Qt Creator菜单栏中的构建，在其下拉菜单中，点击执行qmake，重新运行。

问题解决。

【Qt】之【Bug】LNK2001: 无法解析的外部符号
-笔记-
04-26 1227
error LNK2001: 无法解析的外部符号 "__declspec(dllimport)以这种为前缀的基本上跟库相关的，说明无法正常调用库，一般是路径有问题。查看该文件所在的pro文件里，发现只添加了。
VS2019调用QCustomPlot第三方库报错无法解析的外部命令的解决方法
qq_44881345的博客
11-24 1314
第三方库报错的解决方法
Qt无法解析的外部命令
肩上风骋的博客
01-11 913
程序编译没有问题，上传svn后，下载整个项目后，编译错误，提示多个无法解析的外部的命令。 检查的要点： 程序的编译环境是否正确； 程序需要的库的路径是否正确； 查看库的路径是否正确时，需要查看.pro文件，但是上传svn时这些文件的内容肯定是一样的，故程序需要的静态库是没有问题，由于是编译时不通过，且暂时考虑静态库。在编译环境也正确的情况下，清理项目，删掉生成的文件夹build-…debug，运行qmake，再运行构建或者重新构建，此时还是无法编译通过。考虑到项目中有一个文件夹下的文件被我替换掉了，故需
QT "无法解析的外部命令"的解决办法
人生起猿
02-09 1万+
编译工程出现的问题如下： main.obj:-1: error: LNK2019: 无法解析的外部符号 "public: __cdecl Dialog::Dialog(class QWidget *)" (??0Dialog@@QEAA@PEAVQWidget@@@Z)，该符号在函数 main 中被引用 main.obj:-1: error: LNK2019: 无法解析的外部符号 "publi
QT 无法解析的外部符号-关于QMetaObject 、metacast、qt_metacall是关于元数据meta问题
IvanLJF的专栏
07-12 1192
LNK2001 无法解析的外部符号 “public: virtual int __cdecl Plugin::CCFileDialog::qt_metacall(enum QMetaObject::Call,int,void * *)” (?由于头文件用到了对话框类，且添加了Q_OBJECT，需要从工程中移除此头文件，重新添加即可。
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
QT调用第三方动态链接库时报错error: LNK2019: 无法解析的外部符号 “__declspec(dllimport) “，error: LNK1120: 1 个无法解析的外部命令
WYuan的博客
07-13 9121
QT中错误提示如下： mainwindow.obj???? error: LNK2019: 无法解析的外部符号 “__declspec(dllimport) int __cdecl add(int,int)” (_imp?add@@YAHHH@Z)，该符号在函数 “public: __thiscall MainWindow::MainWindow(class QWidget *)” (??0MainWindow@@QAE@PAVQWidget@@@Z) 中被引用 debug\untitled2.exe???
Qt网络编程遇到无法解析的外部命令解决办法
牙家零少
12-14 2099
在vs2008使用Qt的QUdpSoclet或QTcpSocket等网络类进行编程时，常出现编译通过，生成解决方案时报出一堆无法解析的错误，就像下面一样： moc_mainwindow.obj : error LNK2019: 无法解析的外部符号 "private: void __thiscall MainWindow::on_exitPushBtn_clicked(void)" (?on_ex
Qt5 opencv4 无法解析的外部符号问题（经验篇）
月照大江流的博客
10-15 1572
Qt5 opencv4 无法解析的外部符号问题 这两天在做一个简单的打开本地图片的小功能的时候，在cvtColor的地方，总出现烦人的“无法解析的外部符号问题”，如下图： 首先尝试了 清理项目重新构建的方式，但始终得不到解决，因为我的opencv版本从3.1换成了4.2，所以开始考虑是不是版本升级对于cvtColor函数本身使用带来了变化，再去查阅了解了函数本身之后，做如下改变: 修改之后再重新清理项目，执行qmake，再次运行，得以解决问题！ ...
Qt 无法识别的外部符号.无法解析的外部符号
闲暇余客
10-13 1901
v
QT 无法解析的外部符号（两种情况）
十方御道的博客
04-30 5370
#ifndef MYTHREAD_H #define MYTHREAD_H #include <QThread> class MyThread : public QThread { //Q_OBJECT public: MyThread(); void closeThread(); protected: virtual void run(); signals:...
《QT从基础到进阶·四十一》无法解析的外部符号及生成事件加入QT打包命令报错问题
cs1395293598的博客
06-03 835
qt_metacall@ML_AddinManger@@UEAAHW4Call@QMetaObject@@HPEAPEAX@Z)…该命令的目的是在编译的时候自动把需要的QT依赖编译到release目录下，相当于编译的时候直接打包了一个release版本，如果在生成后事件报错主要是无法识别windeployqt位置，需要在环境变量的path目录下加入QT的bin目录，比如D:\QT\5.15.2\msvc2019_64\bin。第一种写法将 Q_OBJECT 宏放在类的声明之后，而没有换行。
QT链接外部库的时候出现无法解析的外部符号
doujianyoutiao的博客
11-23 3475
出现无法解析的外部符号无非就是找不到那个符号（函数）。 除了常见的那几种解决方式，还有一种情况是编译库的位数不对，比如编译库用的编译器是32位的，但你的程序是用64位编译器的，这时也会出现这种情况。 我出现这种情况的时候，把QT常用的那几种解决方式都没办法解决，直到我把QT的工程去用VS编译的时，在VS的错误列表中看的了一条VS提示的警告。![在这里插入图片描述](https://img-blog...
QT出现：无法解析的外部符号，无法解析的外部命令解决方案
qq_42862882的博客
11-24 9146
个人经验，出现这个报错一共有两种情况： 情况一： 原因： 新建的文件代码和原来已经编译好的代码交互出现了错误，导致编译器误报 解决方案： 去文件管理器找到qt的workspace把编译好的文件夹删掉（文件名一般是：build-项目名-Desktop_Qt_5_11_1_MSVC2017_64bit-Debug） 重新编译 情况二： 原因： 有 在头文件声明，在源文件没有实现的方法 解决方案： 找到...
Qt 无法解析的外部符号 问题汇总
akadiao的博客
08-15 1万+
Qt项目编译生成过程中经常遇到“错误 LNK****** 无法解析的外部符号****** ”这类问题。不同情况产生的原因多种多样，总结有一下几种： 类内使用了信号与槽，但未包含 Q_OBJECT 宏，因此需在类内加上Q_OBJECT ； 所需的库.lib文件未包含到项目： 项目未包含若需Qt模块： 如： 严重性 代码 说明 项目 文件 行 禁止显示状态 错误 LNK2019 无法解析的外部符号 "__declspec(dllimport) public: __cdecl QDomEleme
Qt“无法解析的外部命令” 可能问题
真诚是一种高品质的生活方式
08-27 1908
我在凌晨一点多也犯糊涂了，写了个函数声明，还没写定义就编译，就产生这样的问题，发现问题记录一下，警醒，还是要按着流程先打桩。 转载申明：文章原创作者为各位-请不吝赐教，文章原地址： https://blog.csdn.net/u013776188/article/details/54945005 编译工程出现的问题如下：   mainwindow.obj : error LNK2019: ...
Qt 错误: LNK2019: 无法解析的外部符号 原因及解决办法
Willstone0的博客
06-18 952
# 1.A在B内创建，A和B连接信号与槽，槽内用了A中定义的结构体，但是A的头文件放在了B中。导致B的槽连接有问题。
vs+qt 动态库无法解析外部符号的问题
Learning_Well的博客
07-19 2366
1）先看一下生成的库输入位置在哪里。在动态库项目右击，选择“属性”->链接器->常规->输出文件。（3）还需在要引用的项目属性里，链接器，输入，附加依赖项，设置待引用的库名称。（2）在需要引用的项目右击，选择属性，VC++目录，库目录修改相关路径。1、问题描述无法解析的外部符号。以上确认后，就可以编译生成了。...
Qt5 error LNK2019 无法解析的外部符号 解决办法
Maverick
05-30 1万+
1、问题： 最近使用QT 5.0.2 设计界面，遇到一个纠结的问题： 建立工程后，再新建一个新的类（如class a），类声明在a.h头文件中，在main.cpp中 #include "a.h" 但是在链接过程中报错：类a的所有成员函数（构造函数，析构函数等）均无法识别，被编译器标为“无法解析的外部符号”。   解决： 将当前qt工程所在的父目录下的 build-(工程名)-Deskto
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`宏导致的外部符号错误。
评论 4
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

一叶孤舟渡

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值