VC++中的Link error 2005/2001

      VC++中Link2005/2001是开发人员在开发过程遇到的问题，一直想搞清楚这类错误的原因！总结网上的资料，先总结如下。

     编程中经常能遇到LNK2005错误——重复定义错误，其实LNK2005错误并不是一个很难解决的错误。弄清楚原因，就可以轻松解决它了。造成LNK2005错误主要有以下几种情况：

1．重复定义全局变量。

       A、需要使用全局变量的地方使用定义申明——其实这是错误的，全局变量是针对整个工程的。正确的应该是在一个CPP文件中定义如下：

       int g_Test;

      在使用的CPP文件中就应该使用：

       extern int g_Test

   如果还是使用int g_Test，那么就会产生LNK2005错误，一般错误错误信息类似：

       AAA.obj error LNK2005 int book c？book@@3HA already defined in BBB.obj。

   切记的就是不能给变量赋值否则还是会有LNK2005错误。这里需要的是“声明”，不是“定义”！根据C++标准的规定，一个变量是声明，必须同时满足两个条件，否则就是定义：

       (1)声明必须使用extern关键字

       (2)不能给变量赋初值

   所以，下面的是声明:

              extern int a;

   下面的是定义

              int a; int a = 0; extern int a =0;

       B、在文件中随意定义全局变量，并且对于变量名也仔细考虑，这也往往容易造成变量名重复，而造成LNK2005错误。

2．头文件的包含重复。

   往往需要包含的头文件中含有变量、函数、类的定义，在其它使用的地方又不得不多次包含之，如果头文件中没有相关的宏等防止重复链接的措施，那么就会产生LNK2005错误。解决办法是在需要包含的头文件中做类似的处理：

       #ifndef MY_H_FILE //如果没有定义这个宏

              #define MY_H_FILE //定义这个宏

       ……. //头文件主体内容

       …….

              #endif

   上面是使用宏来做的，也可以使用预编译来做，在头文件中加入：

              #pragma once

//头文件主体

3．使用第三方的库造成的。

    这种情况主要是C运行期函数库和MFC的库冲突造成的。具体的办法就是将那个提示出错的库放到另外一个库的前面。另外选择不同的C函数库，可能会引起这个错误。微软和C有两种C运行期函数库，一种是普通的函数库：LIBC.LIB，不支持多线程。另外一种是支持多线程的：msvcrt.lib。如果一个工程里，这两种函数库混合使用，可能会引起这个错误，一般情况下它需要MFC的库先于C运行期函数库被链接，因此建议使用支持多线程的msvcrt.lib。所以在使用第三方的库之前首先要知道它链接的是什么库，否则就可能造成LNK2005错误。如果不得不使用第三方的库，可以尝试按下面所说的方法修改，但不能保证一定能解决问题，前两种方法是微软提供的：

       A、选择VC菜单Project->Settings->Link->Catagory选择Input，再在Ignore libraries 的Edit栏中填入你需要忽略的库，如：Nafxcwd.lib;Libcmtd.lib。然后在Object/library Modules的Edit栏中填入正确的库的顺序，这里需要你能确定什么是正确的顺序，呵呵，God bless you！

       B、选择VC菜单Project->Settings->Link页，然后在Project Options的Edit栏中输入/verbose:lib，这样就可以在编译链接程序过程中在输出窗口看到链接的顺序了。

       C、选择VC菜单Project->Settings->C/C++页，Catagory选择Code Generation后再在User Runtime libraray中选择MultiThread DLL等其他库，逐一尝试。

关于编译器的相关处理过程，参考：http://www.donews.net/xzwenlan/archive/2004/12/23/211668.aspx。

       VC＋＋时经常会遇到的另一个链接错误为LNK2001，该错误非常讨厌。因为对于编程者来说，最好改的错误莫过于编译错误，而一般说来发生连接错误时，编译都已通过。产生连接错误的原因非常多，尤其LNK2001错误，常常使人不明其所以然。如果不深入地学习和理解VC＋＋，要想改正连接错误LNK2001非常困难。  

       初学者在学习VC＋＋的过程中，遇到的LNK2001错误的错误消息主要为：unresolved   external   symbol   “symbol”（不确定的外部“符号”）。如果连接程序不能在所有的库和目标文件内找到所引用的函数、变量或标签的定义，将产生此错误消息。一般来说，发生错误的原因有两个：一是所引用的函数、变量不存在、拼写不正确或者使用错误，找不到相应定义；其次可能使用了不同版本的连接库。以下是可能产生LNK2001错误的原因：  

1．编码错误导致的LNK2001。  

  　 A、不相匹配的程序代码或模块定义（.DEF）文件能导致LNK2001。例如，如果在C＋＋源文件内声明了一变量“var1”，却试图在另一文件内以变量“VAR1”访问该变量，将发生该错误。  

  　 B、如果使用的内联函数是在.CPP文件内定义的，而不是在头文件内定义将导致LNK2001错误。  

  　 C、调用函数时如果所用的参数类型同函数声明时的类型不符将会产生LNK2001。

  　 D、试图从基类的构造函数或析构函数中调用虚拟函数时将会导致LNK2001。  

        E、要注意函数和变量的可公用性，只有全局变量、函数是可公用的。静态函数和静态变量具有相同 的使用范围限制。当从文件外部访问任何没有在该文件内声明的静态变量时将导致编译错误或LNK2001。函数内声明的变量（局部变量）只能在该函数的范围内使用。C＋＋的全局常量只有静态连接性能。这不同于C，如果试图在C＋＋的多个文件内使用全局变量也会产生LNK2001错误。一种解决的方法是需要时在头文件中加入该常量的初始化代码，并在.CPP文件中包含该头文件；另一种方法是使用时给该变量赋以常数。  

2．由于编译和链接的设置而造成的LNK2001  

  　 A、如果编译时使用的是/NOD（/NODEFAULTLIB）选项，程序所需要的运行库和MFC库在连接时由编译器写入目标文件模块，但除非在文件中明确包含这些库名，否则这些库不会被链接进工程文件。在这种情况下使用/NOD将导致错误LNK2001。  

  　 B、如果没有为wWinMainCRTStartup设定程序入口，在使用Unicode和MFC时将得到“unresolved   external   on   _WinMain@16”的LNK2001错误信息。  

  　 C、使用/MD选项编译时,既然所有的运行库都被保留在动态链接库之内，源文件中对“func”的引用，在目标文件里即对“__imp__func”   的引用。 如果试图使用静态库LIBC.LIB或LIBCMT.LIB进行连接，将在__imp__func上发生LNK2001；如果不使用/MD选项编译，在使用MSVCxx.LIB连接也会发生LNK2001。  

  　　使用/ML选项编译时，如用LIBCMT.LIB链接会在_errno上发生LNK2001。  

  　 D、当编译调试版的应用程序时，如果采用发行版模态库进行连接也会产生LNK2001；同样，使用调试版模态库连接发行版应用程序时也会产生相同的问题。  

  　 E、不同版本的库和编译器的混合使用也能产生问题，因为新版的库里可能包含早先的版本没有的符号和说明。  

  　 F、在不同的模块使用内联和非内联的编译选项能够导致LNK2001。如果创建C＋＋库时打开了函数内联（/Ob1或/Ob2），但是在描述该函数的相应头文件里却关闭了函数内联（没有inline关键字），这时将得到该错误信息。为避免该问题的发生，应该在相应的头文件中用inline关键字标志内联函数。  

  　 G、不正确的/SUBSYSTEM或/ENTRY设置也能导致LNK2001。

    其实，产生LNK2001的原因还有很多，以上的原因只是一部分而已，对初学者来说这些就够理解一阵子了。LNK2001错误虽然比较困难，但是只要注意到了上述问题，还是能够避免和予以解决的。