LINK2001错误

　   学了4年C++，对于VC++来说，接触不多，恐怕自己还是菜鸟。我遇到过一个LINK2001错误，最后搞定。心里还是很高兴的，主要原因就是没有添加外部库函数，导致外部函数找不到定义。

　　VC++入门还是比较难的。对于VC++初学者来说，编译错误是很容易解决的，而连接错误比较难些，其是LINK2001错误，我从别人的BLOG摘下的部分，共享一下。

　　遇到的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的原因还有很多，以上的原因只是一部分而已，对初学者来说这些就够理解一阵子了。但是，分析错误原因的目的是为了避免错误的发生。LNK2001错误虽然比较困难，但是只要注意到了上述问题，还是能够避免和予以解决的。

 

问题1：

Linking...

    nafxcwd.lib(thrdcore.obj) : error LNK2001: unresolved external symbol __endthreadex

    nafxcwd.lib(thrdcore.obj) : error LNK2001: unresolved external symbol __beginthreadex

    libcd.lib(crt0.obj) : error LNK2001: unresolved external symbol _main

答: 

    VC++默认的工程设置是单线程的，而你使用了多线程，所以要修改设置。选择菜单“Project|settings”，选择C/C++标签，在CODE GENERATION分类中选择除SINGLE-THREADED的其他选择。 

   

比如可以在Use run-time library中选择Debug Multithreaded或者multithreaded

其中,

Single-Threaded                单线程静态链接库(release版本)

Multithreaded                  多线程静态链接库(release版本)

multithreaded DLL              多线程动态链接库(release版本)

Debug Single-Threaded          单线程静态链接库(debug版本)

Debug Multithreaded            多线程静态链接库(debug版本)

Debug Multithreaded DLL        多线程动态链接库(debug版本)

单线程: 不需要多线程调用时, 多用在DOS环境下

多线程: 可以并发运行

静态库: 直接将库与程序Link, 可以脱离MFC库运行

动态库: 需要相应的DLL动态库, 程序才能运行

release版本: 正式发布时使用

debug版本: 调试阶段使用 

 

问题2

fatal error C1010: unexpected end of file while looking for precompiled header directive该如何解?

答:  

    如果发生错误的文件是由其他的C代码文件添加进入当前工程而引起的，则Alt+F7进入当前工程的Settings，选择C/C++选项卡，从Category组合框中选中Precompiled Headers，选择Not Using Precompiled headers。确定如果发生错误的文件原本是该工程中的，则检查该文件头部有没有#include "stdafx.h"语句，没有的话添加。

    如果还不行，也有可能是定义的类或结构体等最后忘了加分号，注意一下。

 

问题3：

编译产生c1.exe什么原因？ 

答：

    编译器的问题。可能很多人在安装VC 6.0后有过点击“Compile”或者“Build”后被出现的“Compiling... ,Error spawning cl.exe”错误提示给郁闷过。很多人的选择是重装，实际上这个问题很多情况下是由于路径设置的问题引起的，“CL.exe”是VC使用真正的编译器（编译程序），其路径在“VC根目录\VC98\Bin”下面，你可以到相应的路径下找到这个应用程序。 

     因此问题可以按照以下方法解决：点击VC“TOOLS（工具）”—>“Option（选择）”—>“Directories（目录）”重新设置“Excutable Fils、Include Files、Library Files、Source Files”的路径。很多情况可能就一个盘符的不同（例如你的VC装在C，但是这些路径全部在D），改过来就OK了。

 

问题4：关于工程类型的错误，libcmtd.lib(crt0.obj) : error LNK2001: unresolved external symbol _main 

答:　

　建了console工程，但是主函数写成了winmain,Windows项目要使用Windows子系统, 而不是Console, 可以这样设置:

[Project] --> [Settings] --> 选择"Link"属性页,在Project Options中将/subsystem:console改成/subsystem:windows

这样就把工程改该成了win32的工程，如果要保留成console工程，只要把主函数改成main。 

 

问题5：关于工程类型的错误，提示:LIBCD.lib(wincrt0.obj) : error LNK2001: unresolved external symbol _WinMain@16

答:

　建了win32工程，但是主函数写成了main,控制台项目要使用Console子系统, 而不是Windows, 设置:[Project] --> [Settings] --> 选择"Link"属性页,在Project Options中将/subsystem:windows改成/subsystem:console。这样就把工程改成了console工程。如果要保留win32工程，只要把主函数改成winmain。

 

问题6  程序入口设置错误, 提示:msvcrtd.lib(crtexew.obj) : error LNK2001: unresolved external symbol _WinMain@16

答: 

    通常, MFC项目的程序入口函数是WinMain, 如果编译项目的Unicode版本, 程序入口必须改为wWinMainCRTStartup, 所以需要重新设置程序入口:[Project] --> [Settings] --> 选择"C/C++"属性页,在Category中选择Output,再在Entry-point symbol中填入wWinMainCRTStartup, 即可。  

 

问题7：LNK2001错误，如error LNK2001: unresolved external symbol ………………

一般这种错误是没有把需要的某些lib加到你的工程里面，这里举个例子吧：error LNK2001: unresolved external symbol __imp__waveOutGetNumDevs@0

答: 

    看到这种错误，去msdn查一下waveOutGetNumDevs这个函数，然后看最后的Requirements 

　 Requirements

    Windows NT/2000/XP: Included in Windows NT 3.1 and later.

    Windows 95/98/Me: Included in Windows 95 and later.

    Header: Declared in Mmsystem.h; include Windows.h.

    Library: Use Winmm.lib.

 

　 于是把Winmm.lib　加到project ->setting->link->object/library modules或者#pragma comment(lib,"Winmm")//加了这个就不用到setting中再加lib了。

 　　

　 初学者在学习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的原因还有很多，以上的原因只是一部分而已，对初学者来说这些就够理解一阵子了。但是，分析错误原因的目的是为了避免错误的发生。LNK2001错误虽然比较困难，但是只要注意到了上述问题，还是能

够避免和予以解决的。