VS链接器工具错误 LNK2019：无法解析的外部符号

常见的问题

以下是一些导致 LNK2019 的常见问题：

• 未链接的对象文件或包含符号定义的库。 在 Visual Studio 中，验证包含定义源代码文件是生成，分别链接为项目的一部分。 在命令行中，验证编译时包含定义的源文件，并且所生成对象文件包含在要链接的文件列表。

• 符号的声明不拼写与符号的定义相同。 验证在声明和定义，使用正确的拼写和大小写，并且是使用或调用该符号的任何位置。

• 使用一个函数，但数量的参数的类型与函数定义不匹配。 函数声明必须匹配定义。 验证函数调用是否匹配声明以及声明是否匹配定义。 调用模板函数的代码还必须拥有包括与定义相同的模板参数的匹配模板函数声明。 模板声明不匹配的示例，请参阅示例 LNK2019e.cpp 示例部分中。

• 声明但未定义的函数或变量。 这通常意味着在标头文件中，存在声明，但不匹配定义实现。 对于成员函数或静态数据成员，实现必须包括类范围选择器。 有关示例，请参见 Missing Function Body or Variable。

• 调用约定是函数声明和函数定义之间的差异。 调用约定 (__cdecl、 __stdcall、 __fastcall、 or __vectorcall) 作为修饰名称的一部分进行编码。 验证调用约定是否相同。

• 符号定义在 C 文件中，但未使用 extern"C"在 c + + 文件中进行声明。 在作为 C 编译的文件中定义的符号拥有与在 C++ 文件中声明的符号不同的修饰名称，除非使用了 extern "C" 修饰符。 验证声明是否匹配每个符号的编译链接。

  同样，如果在 C 程序将使用的 C++ 文件中定义符号，请在定义中使用 extern "C" 。

• 一个符号是定义为静态，然后更高版本在文件外部引用。 与 C 不同，在 C++ 中， 全局常量 拥有 static 链接。 若要避开此限制，你可以在头文件中包括 const 初始化并将该标头包括在你的 .cpp 文件中，或者你可以让变量成为非常量并使用常量引用来访问它。

• 未定义一个类的静态成员。 静态类成员必须拥有唯一的定义，否则它将违反单个定义规则。 无法以内联方式定义的静态类成员必须通过使用其完全限定名称在一个源文件中进行定义。 如果没有进行定义，那么链接器会生成 LNK2019。

• 生成依赖项仅定义为解决方案中项目依赖项。 在 Visual Studio的早期版本中，此级别的依赖项已经足够。 但是，从 Visual Studio 2010 开始， Visual Studio 要求 项目到项目引用。 如果你的项目没有项目到项目引用，那么你可能收到此链接器错误。 添加项目到项目引用以修复此错误。

• 你通过使用 Windows 应用程序的设置生成了控制台应用程序。 如果错误消息是类似于WinMain 函数中引用的无法解析外部符号function_name，通过使用链接/subsystem: console而不是/SUBSYSTEM:WINDOWS。 有关此设置的详细信息以及如何在 Visual Studio 中设置此属性的说明，请参阅 /SUBSYSTEM (Specify Subsystem)。

• 为在不同的源文件中内联的函数使用不同的编译器选项。 使用 .cpp 文件中定义的内联函数并在不同源文件中混合使用函数内联编译器可能会导致 LNK2019。 有关详细信息，请参阅 Function Inlining Problems。

• 在其范围之外使用自动变量。 自动（函数范围）变量仅可在该函数的范围内使用。 这些变量不可声明为 extern ，也不能在其他源文件中使用。 有关示例，请参见 Automatic (Function Scope) Variables。

• 调用内部函数，或将参数类型传递到目标体系结构不支持的内部函数。 例如，如果你使用 AVX2 内部函数，但未指定 /ARCH:AVX2 编译器选项，那么编译器会假定该内部函数是外部函数。 编译器不会生成内联指令，相反，它会生成一个对与内部函数同名的外部符号的调用。 当链接器尝试找到此缺失函数的定义时，它会生成 LNK2019。 验证是否只使用了目标体系结构支持的内部函数和类型。

• 混合的代码不使用本机 wchar_t 的代码。 在 Visual C++ 2005 中完成的 C++ 语言一致性工作让 wchar_t 成为默认本机类型。 你必须使用 /Zc:wchar_t- 编译器选项来生成兼容使用 Visual C++ 早期版本进行编译的库和对象文件的代码。 如果并非所有文件都已经使用相同的 /Zc:wchar_t 设置进行编译，那么类型引用可能不会解析为兼容的类型。 验证所有库和对象文件中的 wchar_t 类型是否兼容，方法是更新使用的类型或在编译时使用一致的 /Zc:wchar_t 设置。

实际遇到的问题

1.在创建工程的时候，选择了Win32项目，然后选择了控制台应用程序时，链接时会出现错误:

LNK2019无法解析的外部符号 _WinMain@16，该符号在函数 "int __cdecl invoke_main(void)" (?invoke_main@@YAHXZ) 中被引用

解决方法：链接器>>系统>>子系统>>窗口（/SUBSYSTEM:WINDOWS）改为控制台（SUBSYSTEM:CONSOLE）

2.在cpp文件中，如果存在C定义的符号，例如：#pragma comment(lib, avutil.lib) ,要将其放在extern "C"内

参考地址：https://msdn.microsoft.com/query/dev14.query?appId=Dev14IDEF1&l=ZH-CN&k=k(LNK2019)&rd=true