解决error LNK2001: unresolved external symbolimpxxx

最新推荐文章于 2026-07-24 10:46:07 发布

原创最新推荐文章于 2026-07-24 10:46:07 发布 · 8.7k 阅读

9 ·

本内容遵循CC 4.0 BY-SA版权协议

收录于

编程笔记

本文详细解析了VC++编程中LNK2001错误的原因及其解决方法，包括编码错误、编译和链接设置不当等，并提供了具体的实例和解决方案，如加入必要的库文件、正确配置编译选项等，帮助开发者避免和解决这类常见问题。

学习VC＋＋时经常会遇到链接错误LNK2001，该错误非常讨厌，因为对于编程者来说，最好改的错误莫过于编译错误，而一般说来发生连接错误时，编译都已通过。产生连接错误的原因非常多，尤其LNK2001错误，常常使人不明其所以然。如果不深入地学习和理解VC＋＋，要想改正连接错误LNK2001非常困难。
初学者在学习VC＋＋的过程中，遇到的LNK2001错误的错误消息主要为：
unresolved    external    symbol    “symbol”（不确定的外部“符号”）。
如果连接程序不能在所有的库和目标文件内找到所引用的函数、变量或标签，将产生此错误消息。一般来说，发生错误的原因有两个：一是所引用的函数、变量不存在、拼写不正确或者使用错误；其次可能使用了不同版本的连接库。
以下是可能产生LNK2001错误的原因：
一．由于编码错误导致的LNK2001。
1．不相匹配的程序代码或模块定义(.DEF)文件能导致LNK2001。例如, 如果在C＋＋    源文件内声明了一变量“var1”，却试图在另一文件内以变量“VAR1”访问该变量,将发生该错误。
2．如果使用的内联函数是在.CPP文件内定义的，而不是在头文件内定义将导致LNK2001错误。
3．调用函数时如果所用的参数类型同函数声明时的类型不符将会产生LNK2001。
4．试图从基类的构造函数或析构函数中调用虚拟函数时将会导致LNK2001。
5．要注意函数和变量的可公用性，只有全局变量、函数是可公用的。
静态函数和静态变量具有相同的使用范围限制。当试图从文件外部访问任何没有在该文件内声明的静态变量时将导致编译错误或LNK2001。
函数内声明的变量(局部变量)    只能在该函数的范围内使用。
C＋＋的全局常量只有静态连接性能。这不同于C，如果试图在C＋＋的多个文件内使用全局变量也会产生LNK2001错误。一种解决的方法是需要时在头文件中加入该常量的初始化代码，并在.CPP文件中包含该头文件；另一种方法是使用时给该变量赋以常数。
二．由于编译和链接的设置而造成的LNK2001
1．如果编译时使用的是/NOD(/NODEFAULTLIB)选项，程序所需要的运行库和MFC库在连接时由编译器写入目标文件模块，    但除非在文件中明确包含这些库名，否则这些库不会被链接进工程文件。在这种情况下使用/NOD将导致错误LNK2001。
   　　2．如果没有为wWinMainCRTStartup设定程序入口，在使用Unicode和MFC时将得到“unresolved    external    on    _WinMain@16”的LNK2001错误信息。
   　　3．使用/MD选项编译时,既然所有的运行库都被保留在动态链接库之内，源文件中对“func”的引用，在目标文件里即对“__imp__func”    的引用。如果试图使用静态库LIBC.LIB或LIBCMT.LIB进行连接，将在__imp__func上发生LNK2001；如果不使用/MD选项编译，在使用MSVCxx.LIB连接时也会发生LNK2001。
   　　4．使用/ML选项编译时，如用LIBCMT.LIB链接会在_errno上发生LNK2001。
   　　5．当编译调试版的应用程序时，如果采用发行版模态库进行连接也会产生LNK2001；同样，使用调试版模态库连接发行版应用程序时也会产生相同的问题。
   　　6．不同版本的库和编译器的混合使用也能产生问题，因为新版的库里可能包含早先的版本没有的符号和说明。
   　　7．在不同的模块使用内联和非内联的编译选项能够导致LNK2001。如果创建C＋＋库时打开了函数内联（/Ob1或/Ob2)，但是在描述该函数的相应头文件里却关闭了函数内联（没有inline关键字），这时将得到该错误信息。为避免该问题的发生，应该在相应的头文件中用inline关键字标志内联函数。
   　　8．不正确的/SUBSYSTEM或/ENTRY设置也能导致LNK2001。
   　　其实，产生LNK2001的原因还有很多，以上的原因只是一部分而已，对初学者来说这些就够理解一阵子了。但是，分析错误原因的目的是为了避免错误的发生。NK2001错误虽然比较困难，但是只要注意到了上述问题，还是能够避免和予以解决的。

三、解决方法

1) vc网络编程中遇到一个编译问题，原来是少了WSOCK32.LIB。
在 project-->settings-->Link-->Object/Library modules 中加入库WSOCK32.LIB即可。
在VC中进行WINSOCK的API编程开发的时候，需要在项目中使用下面三个文件，否则会出现编译错误。
　　1．WINSOCK.H: 这是WINSOCK API的头文件，需要包含在项目中。
　　2．WSOCK32.LIB: WINSOCK API连接库文件。在使用中，一定要把它作为项目的非缺省的连接库包含到项目文件中去。
　　3．WINSOCK.DLL: WINSOCK的动态连接库，位于WINDOWS的安装目录下。

--------------------Configuration: Example1 - Win32 Debug--------------------
Linking...
error LNK2001: unresolved external symbol _connect@12
error LNK2001: unresolved external symbol _htons@4
error LNK2001: unresolved external symbol _inet_addr@4
error LNK2001: unresolved external symbol _socket@12
error LNK2001: unresolved external symbol _closesocket@4
error LNK2001: unresolved external symbol _send@16
error LNK2001: unresolved external symbol _recv@16
error LNK2001: unresolved external symbol _WSAAsyncSelect@16
error LNK2001: unresolved external symbol _accept@12
error LNK2001: unresolved external symbol _listen@8
error LNK2001: unresolved external symbol _bind@12

(2) vc数据库SQL编程中遇到一个问题，原来是少了odbc32.lib。
在 project-->settings-->Link-->Object/Library modules 中加入库odbc32.lib 即可。
mfc程序调用了odbc api,连接时出错:
error   LNK2001:   unresolved   external   symbol   _SQLConnect@28
error   LNK2001:   unresolved   external   symbol   _SQLFetch@4
error   LNK2001:   unresolved   external   symbol   _SQLBindCol@24
error   LNK2001:   unresolved   external   symbol   _SQLFreeHandle@8
error   LNK2001:   unresolved   external   symbol   _SQLExecDirect@12
error   LNK2001:   unresolved   external   symbol   _SQLAllocHandle@12
error   LNK2001:   unresolved   external   symbol   _SQLSetEnvAttr@16
error   LNK2001:   unresolved   external   symbol   _SQLDisconnect@4

(3) vc   OpenCV图像处理编程中遇到一个问题，原来是少了cv.lib cvaux.lib cxcore.lib highgui.lib。
在 project-->settings-->Link-->Object/Library modules 中加入库cv.lib cvaux.lib cxcore.lib highgui.lib 即可。
error LNK2001: unresolved external symbol _cvReleaseImage
error LNK2001: unresolved external symbol _cvWaitKey
error LNK2001: unresolved external symbol _cvDrawContours
error LNK2001: unresolved external symbol _cvReleaseMemStorage
error LNK2001: unresolved external symbol _cvDestroyWindow
error LNK2001: unresolved external symbol _cvFindContours
error LNK2001: unresolved external symbol _cvCvtColor
error LNK2001: unresolved external symbol _cvCreateImage
error LNK2001: unresolved external symbol _cvGetSize
error LNK2001: unresolved external symbol _cvShowImage
error LNK2001: unresolved external symbol _cvLoadImage
error LNK2001: unresolved external symbol _cvNamedWindow
error LNK2001: unresolved external symbol _cvCreateMemStorage

(4) vc OpenGL三维编程中遇到一个问题，原来是少了OpenGL32.lib GLu32.lib GLaux.lib。
在 project-->settings-->Link-->Object/Library modules 中加入库OpenGL32.lib GLu32.lib GLaux.lib 即可。
error LNK2001: unresolved external symbol _gluPerspective@32
error LNK2001: unresolved external symbol _gluLookAt@72
error LNK2001: unresolved external symbol __imp__glLoadIdentity@0
error LNK2001: unresolved external symbol __imp__glMatrixMode@4
error LNK2001: unresolved external symbol __imp__glViewport@16
error LNK2001: unresolved external symbol __imp__glHint@8
error LNK2001: unresolved external symbol __imp__glDepthFunc@4
error LNK2001: unresolved external symbol __imp__glEnable@4
error LNK2001: unresolved external symbol __imp__glClearDepth@8
error LNK2001: unresolved external symbol __imp__glClearColor@16
error LNK2001: unresolved external symbol __imp__glShadeModel@4
error LNK2001: unresolved external symbol __imp__glEnd@0
error LNK2001: unresolved external symbol __imp__glVertex3f@12
error LNK2001: unresolved external symbol __imp__glBegin@4
error LNK2001: unresolved external symbol __imp__glTranslatef@12
error LNK2001: unresolved external symbol __imp__glClear@4
error LNK2001: unresolved external symbol __imp__wglDeleteContext@4
error LNK2001: unresolved external symbol __imp__wglMakeCurrent@8
error LNK2001: unresolved external symbol __imp__wglCreateContext@4

(5) vc VFW视频采集编程中遇到一个问题，原来是少了VFW32.Lib
在 project-->settings-->Link-->Object/Library modules 中加入库VFW32.Lib 即可。
error LNK2001: unresolved external symbol _capCreateCaptureWindowA@32