vs2019静态库链接时报 error LNK2019: 无法解析的外部符号

ljqiankun

已于 2023-03-23 15:23:26 修改

阅读量3k

点赞数 2

分类专栏： qt编程文章标签： qt5 c++ visualstudio

于 2023-02-27 12:54:53 首次发布

本文链接：https://blog.youkuaiyun.com/ljqiankun/article/details/129239722

版权

qt编程专栏收录该内容

5 篇文章

订阅专栏

文章讲述了在VisualStudio2019中创建静态库项目时遇到的问题，当静态库和exe项目都包含特定头文件时，由于宏QCOMMON_EXPORT的不正确使用导致静态库链接错误。解决方案包括修改宏定义或避免使用特定头文件。此外，文章还提到未完全定义的类在不同文件间的使用可引发LNK2019错误，需确保所有依赖类的完整定义。

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

vs2019静态库项目会默认有一个头文件（如qcommon_global.h），如下：

#pragma once

#include <QtCore/qglobal.h>

#ifndef BUILD_STATIC
# if defined(QCOMMON_LIB)
#  define QCOMMON_EXPORT Q_DECL_EXPORT
# else
#  define QCOMMON_EXPORT Q_DECL_IMPORT
# endif
#else
# define QCOMMON_EXPORT
#endif

静态库编译时，因为默认定义了BUILD_STATIC，所以QCOMMON_EXPORT宏默认为空，可以正常编译并生成lib。

但是在exe项目中链接该lib时，如果也带上这个头文件，那么QCOMMON_EXPORT宏的定义就是Q_DECL_IMPORT，这个是动态链接库（dll）链接时需要的，静态库就会报错。

解决方法就是静态库的头文件中去掉Q_DECL_IMPORT宏，或者重新定义Q_DECL_IMPORT宏为空，不要用默认头文件（qcommon_global.h）中的定义。

另外还有一种情况也会报LNK2019错误，看一个示例：

class MyMsg;
class test
{
    int doPublish(const MyMsg& msg);//发送消息 
};

这样能够正常编译，但是因为test的头文件中只有MyMsg的声明，没有定义，实际调用doPublish的时候就会报LNK2019错误。这时候就要把class MyMsg的头文件放进来。