链接器工具错误 LNK2019

在函数“function”中引用了无法解析的外部符号“symbol”,在 function 中找到了未定义的外部符号 (symbol)。

下面的示例生成 LNK2019。

// LNK2019.cpp
// LNK2019 expected
extern char B[100];   // B is not available to the linker
int main() {
   B[0] = ' ';
}

声明但不定义静态数据成员时，也可能发生 LNK2019。   下面的示例生成 LNK2019。

// LNK2019b.cpp
// LNK2019 expected
struct C {
   static int s;
};

// Uncomment the following line to resolve.
// int C::s;

int main() {
   C c;
   C::s = 1;
}

如果在生成中包含的某个文件中没有定义 i 和 g，则链接器将生成 LNK2019。   可以添加这些定义，方法是将包含这些定义的源代码文件作为编译的一部分包括进来。   或者，可以将包含这些定义的 .obj 文件或 .lib 文件传递给链接器。

// LNK2019c.cpp
// LNK2019 expected
extern int i;
extern void g();
void f() {
   i++;
   g();
}
int main() {}

对于在早期版本中创建并升级到当前版本的 C++ 项目，如果定义了  __UNICODE  并且入口点为 WinMain，则必须将入口点函数的名称更改为 _tWinMain 或 wWinMain。

导致 LNK2019 的常见问题包括：

• 符号声明的拼写与符号定义不同。

• 使用了一个函数，但其参数的类型或数量与函数定义不匹配。

• 生成依赖项仅在解决方案中定义为项目依赖项。 在早期版本的 Visual Studio 中，此依赖项级别已足够。 但是，从 Visual Studio 2010 开始，Visual Studio 需要项目到项目的引用。 如果您的项目没有项目到项目的引用，则可能会收到此链接器错误。

• 函数声明使用和函数定义使用中的调用约定（__cdecl、__stdcall 或 __fastcall）不同。

• 符号定义在编译为 C 程序的文件中，而符号是在 C++ 文件中不带 extern "C" 修饰符声明的。 如果是这样，请修改声明。 例如，不要使用

extern int i;
extern void g();

而是使用

extern "C" int i;
extern "C" void g();

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

• 符号定义为静态，但稍后在文件外部被引用。 与 C 不同，在 C++ 中全局常数具有 static 链接。 若要避免此限制，可以将 const 初始化包括在头文件中，并将此头包括在 .cpp 文件中，也可以使变量成为非常数，然后使用常数引用访问它。

• 没有定义静态类成员。 例如，应单独定义下面示例中类声明中的成员变量 si。

  // LNK2019d.cpp
  #include <stdio.h>
  struct X {
     static int si;
  };
  
  // int X::si = 0;   // uncomment this line to resolve
  
  int main() {
     X *px = new X[2];
     printf_s("\n%d",px[0].si);   // LNK2019
  }

  
  
  

下面的示例生成与用户定义的运算符有关的 LNK2019。

// LNK2019e.cpp
// compile with: /EHsc
// LNK2019 expected
#include <iostream>
using namespace std;

template<class T> class 
Test {
   friend ostream& operator<<(ostream&, Test&);
   // Uncomment the following line to resolve.
   // template<typename T> friend ostream& operator << (ostream&, Test<T>&);
};

template<typename T>
ostream& operator<<(ostream& os, Test<T>& tt) {
   return os;
}

int main() {
   Test<int> t;
   cout << "Test: " << t << endl;   // unresolved external
}

/VERBOSE 链接器选项可以帮助您确定链接器引用的文件。 DUMPBIN 实用工具的 /EXPORTS 和 /SYMBOLS 选项还可以帮助您发现在 .dll 和对象/库文件中定义的符号。

有关 LNK2019 的更多信息，请参见 Microsoft 支持网站。

为 Visual Studio .NET 2003 执行的一致性工作（模板友元和专用化）也可能导致 LNK2019。 在 Visual Studio .NET 2003 中，除非在友元声明中显式指定了模板参数，否则与函数模板同名的友元函数的声明不会引用该函数模板。

如果您未指定模板参数，则友元声明将声明一个非模板函数。

要使代码在 Visual C++ 的 Visual Studio .NET 2003 和 Visual Studio .NET 2002 版本中均有效，请显式指定友元函数的模板参数列表。

// LNK2019f.cpp
// LNK2019 expected
template<class T>
void f(T) {}

template<class T>
struct S {
   friend void f(T);
   // try the folowing line instead
   // friend void f<T>(T);
};

int main() {
   S<int> s;
   f(1);   // unresolved external
}

在 Visual C++ 2005 中执行的一致性工作也可能导致 LNK2019；也就是说，在默认情况下，/Zc:wchar_t 现在处于打开状态。 可能不是所有模块都是使用相同的 /Zc:wchar_t 设置编译的；因此，类型引用可能不会解析为兼容的类型。 请确保所有模块中的类型都是兼容的，方法是使用相应的 /Zc:wchar_t 设置进行进行编译（例如，如果使用 Visual C++ 工具生成将与早期版本中的模块链接的模块，请使用 /Zc:wchar_t-），或者尽可能更新类型以使其兼容。

从注释杂注或通过命令行，将对 comsupp.lib 的显式引用更改为引用 comsuppw.lib 或 comsuppwd.lib；这样做的原因是，在默认情况下，/Zc:wchar_t 现在处于打开状态。 当使用 /Zc:wchar_t- 进行编译时，可继续使用 comsupp.lib。

有关更多信息，请参见 /Zc:wchar_t（wchar_t 是本机类型）。

下面的示例创建一个导出，该导出使用解析为 wchar_t 的 WCHAR。

// LNK2019g.cpp
// compile with: /LD
#include "windows.h"
// WCHAR resolves to wchar_t
__declspec(dllexport) void func(WCHAR*) {}

下面的示例生成 LNK2019。

// LNK2019h.cpp
// compile with: LNK2019g.lib
// LNK2019 expected
__declspec(dllimport) void func(unsigned short*);

int main() {
   func(0);
}

若要解决此错误，请将 unsigned short 更改为 wchar_t 或 WCHAR，或使用 /Zc:wchar_t- 编译 LNK2019g.cpp。

如果使用 /SUBSYSTEM:WINDOWS 生成控制台应用程序，也可能收到 LNK2019。 无法解析的符号将是 _WinMain@16。 在这种情况下，只需使用 /SUBSYSTEM:CONSOLE 进行链接。

from msdn