“error LNK2019/LNK2001: 无法解析的外部符号”原因归类

先上结论：

错误原因有3种情况：

1，头文件中声明的函数，无法在.lib文件中找到实现，要么是缺少.lib文件，要么是.lib文件的引用路径不对；

2，头文件中声明的函数，无法在.cpp文件中找到实现，要么是缺少.cpp文件，要么是.cpp文件的引用路径不对；

3，缺少extern c声明

 

具体分析：

最近在移植obs studio源码，出现了很多2019/2001的错误。

编译时出现类似这样的错误：obs_main.obj : error LNK2019: 无法解析的外部符号 _prepareRender，该符号在函数 _doRender@16 中被引用。这种错误的本质是链接器无法在已编译的obj、lib或dll文件中找到函数定义。

经仔细检查代码，错误原因如下：由于是移植的代码，而且obs这个库是在cmake中通过add_subdirectory方式引入的，其编译出来是库文件。此时，即便是项目中有实现文件的源码，那么也不会自动在其中寻找头文件中声明函数的具体实现。由于找不到声明函数的实现，所以就报出了无法解析的符号这个错误。

修改策略：通过target_link_libraries，引入所需要导入库obs.lib。

总结：有头文件（有了函数声明）却没有lib。一般出现于你使用了第三方提供的库，下载了头文件却忘了载库文件，或库文件忘记放到相应的目录下了。

除了上述lib缺失导致的情况外，还有以下两种情况也会出现：

1、在.cpp文件中找不到.h文件中声明函数的实现。你自己写的函数声明的头文件也写了函数定义的cpp文件，却依然出现LNK2019错误。可能原因：忘记将这两个文件加入工程了。一般出现于用Visual Studio和记事本（或UltraEdit）混合开发过程，你用记事本include了相应的头文件，却忘了在Visual Studio的工程中加入它们了。也可能出现于在解决方案的开发过程，在解决方案下的某个工程中加入了它们却忘了在其他工程中加入，我只接触过VC 6和VS 2008，中间好多年没用过新版本VS，到2008时突然发现怎么多了个“解决方案”，“解决方案”下面还可以放好多工程，于是经常在一个工程中写了共享的源代码，却忘了在别的工程中加入它们。这个问题类似于第1个，不同的是这个库是你自己提供的，但没有把它交给VS 2008编译出来。

3、缺少导出c接口。你自己写的函数声明的头文件也写了函数定义的cpp文件也加入工程了而且你很确定函数体肯定是在这个库文件中，却依然出现LNK2019错误。可能原因：C语言和C++语言混编，因为C++支持函数重载所以C++编译器生成的库文件中的函数名会面目全非，例如C编译器会生成 _readRegmark 这个函数名，而C++编译器则生成了"void __cdecl readRegmark(char *)" (?readRegmark@@YAXPAD@Z)这么个函数名。当你的函数是用C语言写的，VS编译器会按C语言规则编译，但链接器却不知道还傻傻的用C++规则的函数名去找结果就找不到了，而你还百般肯定TM的不就在这个库中吗你个睁眼瞎。解决：在C语言的头文件中加入

#ifdef __cplusplus
extern "C" {
#endif

void readRegmark(char *regmark);  //这里写函数声明

#ifdef __cplusplus
}
#endif