16,472
社区成员
发帖
与我相关
我的任务
分享VC++的链接错误LNK2005总结
VC++的链接错误LNK2005
编程中经常能遇到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
这就是我所遇到过的LNK2005错误的几种情况，肯定还有其他的情况也可能造成这种错误，所以我不希望你在看完这篇文章以后，再遇到LNK2005错误时候，不动脑筋的想对号入座的排除错误。编程的过程就是一个思考的过程，所以还是多多开动你的头脑，那样收获会更多！
编程中经常能遇到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
这就是我所遇到过的LNK2005错误的几种情况，肯定还有其他的情况也可能造成这种错误，所以我不希望你在看完这篇文章以后，再遇到LNK2005错误时候，不动脑筋的想对号入座的排除错误。编程的过程就是一个思考的过程，所以还是多多开动你的头脑，那样收获会更多！
...全文
请发表友善的回复…
发表回复
老夏Max 2005-09-09
- 打赏
- 举报
微软的MSDN中查到信息的
可能的原因
不慎同时与单线程库和多线程库链接。确保应用程序项目文件只包括适当的库，并且任何第三方库已适当创建了单线程或多线程版本。
该符号为封装函数（通过用 /Gy 编译创建），包含在多个文件中，但在各编译间已改变。重新编译所有包含 symbol 的文件。
以不同的形式在不同库中的两个成员对象中定义了该符号，并且使用了这两个成员对象。
某个绝对符号被定义两次，而每次定义的值不同。
头文件声明并定义了变量。可能的解决方案有：
在 .h 中声明变量：extern BOOL MyBool;，然后在 .c 或 .cpp 文件中向它分配：BOOL MyBool = FALSE;。
将变量声明为 Static。
将变量声明为 selectany。
当将 uuid.lib 与定义 GUID 的其他 .lib 文件（例如 oledb.lib 和 adsiid.lib）一起使用时。例如：
oledb.lib(oledb_i.obj) : error LNK2005: _IID_ITransactionObject
already defined in uuid.lib(go7.obj)
若要修复，请将 /FORCE:MULTIPLE 添加到链接器命令行选项，并确保 uuid.lib 是引用的第一个库。
有关更多信息，请参阅知识库文章：
Q148652，PRB: LNK2005 Errors When Link C Run-Time Libraries Are Linked Before MFC Libraries。
Q140440，FIX: Global Overloaded Delete Operator Causes LNK2005。
Q184235，PRB: LNK2005 Errors on New and Delete When Defining _ATL_MIN_CRT。
该错误之后为致命错误 LNK1169。
可能的原因
不慎同时与单线程库和多线程库链接。确保应用程序项目文件只包括适当的库，并且任何第三方库已适当创建了单线程或多线程版本。
该符号为封装函数（通过用 /Gy 编译创建），包含在多个文件中，但在各编译间已改变。重新编译所有包含 symbol 的文件。
以不同的形式在不同库中的两个成员对象中定义了该符号，并且使用了这两个成员对象。
某个绝对符号被定义两次，而每次定义的值不同。
头文件声明并定义了变量。可能的解决方案有：
在 .h 中声明变量：extern BOOL MyBool;，然后在 .c 或 .cpp 文件中向它分配：BOOL MyBool = FALSE;。
将变量声明为 Static。
将变量声明为 selectany。
当将 uuid.lib 与定义 GUID 的其他 .lib 文件（例如 oledb.lib 和 adsiid.lib）一起使用时。例如：
oledb.lib(oledb_i.obj) : error LNK2005: _IID_ITransactionObject
already defined in uuid.lib(go7.obj)
若要修复，请将 /FORCE:MULTIPLE 添加到链接器命令行选项，并确保 uuid.lib 是引用的第一个库。
有关更多信息，请参阅知识库文章：
Q148652，PRB: LNK2005 Errors When Link C Run-Time Libraries Are Linked Before MFC Libraries。
Q140440，FIX: Global Overloaded Delete Operator Causes LNK2005。
Q184235，PRB: LNK2005 Errors on New and Delete When Defining _ATL_MIN_CRT。
该错误之后为致命错误 LNK1169。
老夏Max 2005-09-09
- 打赏
- 举报
Knowledge Base
What are the C and C++ libraries my program would link with?
------------------------------------------------------------------
| Compile Old New IOStream Libraries |
| Option IOStream or STL Linked With |
|================================================================|
| /ML Yes No LIBC.LIB, LIBCI.LIB |
| /MDd Yes No MSVCRTD.LIB, MSVCIRTD.LIB |
你的程序使用了/ML编译选项,而程序依赖的.lib可能使用/MDd选项编译,造成链接冲突.
统一编译选项可回避此错误
Project Settings->C/C++ Tab->Category:CodeGeneration
Use run-time library组合框中选择Multithread Dll(或Debug Multithread Dll )
注意：所有相关工程都应该选择相同编译选项
What are the C and C++ libraries my program would link with?
------------------------------------------------------------------
| Compile Old New IOStream Libraries |
| Option IOStream or STL Linked With |
|================================================================|
| /ML Yes No LIBC.LIB, LIBCI.LIB |
| /MDd Yes No MSVCRTD.LIB, MSVCIRTD.LIB |
你的程序使用了/ML编译选项,而程序依赖的.lib可能使用/MDd选项编译,造成链接冲突.
统一编译选项可回避此错误
Project Settings->C/C++ Tab->Category:CodeGeneration
Use run-time library组合框中选择Multithread Dll(或Debug Multithread Dll )
注意：所有相关工程都应该选择相同编译选项
老夏Max 2005-09-09
- 打赏
- 举报
最后要说明的：事物是在不断变化中的，C++的标准在变化，编译器也在变化，所以并不是所有的LNK2005错误都可以在这里找到答案，但是至少它能给你以提示。学习并思考才是正确的！
不断思考吧，让你的头发越来越少，^_^
不断思考吧，让你的头发越来越少，^_^
老夏Max 2005-09-09
- 打赏
- 举报
有时候因为工程使用了预编译头文件并且是增量编译，所以当你改动以后可能也会出现LNK2005错误，提示“XXXX已经在XXXX.obj文件中定义”的消息，这时候只要Rebuild All一般都能解决问题。这是因为头文件的顺序被改动等等操作造成的。
不可触碰 2005-06-13
- 打赏
- 举报
学习再学习
modena 2005-06-13
- 打赏
- 举报
出差刚回来:$
Tools | Options | Project | VC++ Directory
Include files:
$(VCIstallDir)PlatformSDK\include\prerelease
$(VCIstallDir)PlatformSDK\include
$(VCIstallDir)include
$(VCIstallDir)atlmfc\include
Library files:
$(VCIstallDir)PlatformSDK\lib\prerelease
$(VCIstallDir)PlatformSDK\lib
$(VCIstallDir)lib
$(VCIstallDir)atlmfc\lib
我编译是没有问题的，我遇到的一个类似的问题是通过这种方式解决的，我也不知道你的问题是否能够通过这种方法解决
Tools | Options | Project | VC++ Directory
Include files:
$(VCIstallDir)PlatformSDK\include\prerelease
$(VCIstallDir)PlatformSDK\include
$(VCIstallDir)include
$(VCIstallDir)atlmfc\include
Library files:
$(VCIstallDir)PlatformSDK\lib\prerelease
$(VCIstallDir)PlatformSDK\lib
$(VCIstallDir)lib
$(VCIstallDir)atlmfc\lib
我编译是没有问题的，我遇到的一个类似的问题是通过这种方式解决的，我也不知道你的问题是否能够通过这种方法解决
zengfancy 2005-06-09
- 打赏
- 举报
与资深的程序员比起来，感到自己差距还很远啊！
虽然自己graduate前面还有个post.
学习ing
虽然自己graduate前面还有个post.
学习ing
he_sl 2005-06-09
- 打赏
- 举报
mark
Sander 2005-06-09
- 打赏
- 举报
我也有一个是namespace照成的Link2005错，现在还不知道原因
请楼主分析一下：）
------------------------
我有一个头文件 CDateMgr.h，包含另一个用namespace 的head file(DateMgrConst.h) 如下：
#ifndef DATEMGRCONST_H
#define DATEMGRCONST_H
namespace // hide from global namespace
{
namespace Weekday
{
const int SUNDAY = 0;
const int MONDAY = 1;
const int TUESDAY = 2;
const int WEDNESDAY = 3;
const int THURSDAY = 4;
const int FRIDAY = 5;
const int SATURDAY = 6;
}
#endif
------------
我在dos下， 没问题，
在MFC下的DemoDlg就有问题。
后来我把DateMgrConst.h 放到DateMgr.cpp就没有问题了， 请教这是什么原因？！
请楼主分析一下：）
------------------------
我有一个头文件 CDateMgr.h，包含另一个用namespace 的head file(DateMgrConst.h) 如下：
#ifndef DATEMGRCONST_H
#define DATEMGRCONST_H
namespace // hide from global namespace
{
namespace Weekday
{
const int SUNDAY = 0;
const int MONDAY = 1;
const int TUESDAY = 2;
const int WEDNESDAY = 3;
const int THURSDAY = 4;
const int FRIDAY = 5;
const int SATURDAY = 6;
}
#endif
------------
我在dos下， 没问题，
在MFC下的DemoDlg就有问题。
后来我把DateMgrConst.h 放到DateMgr.cpp就没有问题了， 请教这是什么原因？！
fengge8ylf 2005-06-07
- 打赏
- 举报
具体的怎么做 我用的是.NET 谢谢
angelcool 2005-06-07
- 打赏
- 举报
xue xi
mengqimxz 2005-06-07
- 打赏
- 举报
搂主真好
newcore 2005-06-07
- 打赏
- 举报
好人.
modena 2005-06-02
- 打赏
- 举报
如果不麻烦的化，请这样试一下：在VC环境选项中，将VC＋＋目录中的Include和Lib目录PlatformSDK目录移至VC＋＋（MFC/ATLMFC）目录之前，然后Rebuild All试试
wangrong1478 2005-06-01
- 打赏
- 举报
楼主的大恩大德，在下永生难忘up
fengge8ylf 2005-06-01
- 打赏
- 举报
UP
fengge8ylf 2005-06-01
- 打赏
- 举报
modena(非云) UNICODE版本还是不行 你可以去网上下载个crypto库 然后在MFC中用用试试
我发现如果MFC是静态连接的话就可以了
我发现如果MFC是静态连接的话就可以了
modena 2005-06-01
- 打赏
- 举报
你编译的是UNICODE版本吗？用到模板库不知道UNICODE吗？
summer54 2005-05-31
- 打赏
- 举报
up
fengge8ylf 2005-05-31
- 打赏
- 举报
modena(非云) 你好 加上你给的那段程序 现在出现2001和2019的问题 好象和STL冲突
CADlg.obj : error LNK2001: unresolved external symbol "__declspec(dllimport) public: class std::basic_streambuf<wchar_t,struct std::char_traits<wchar_t> > * __thiscall std::basic_ios<wchar_t,struct std::char_traits<wchar_t> >::rdbuf(void)const " (__imp_?rdbuf@?$basic_ios@_WU?$char_traits@_W@std@@@std@@QBEPAV?$basic_streambuf@_WU?$char_traits@_W@std@@@2@XZ)
CA.obj : error LNK2019: unresolved external symbol "__declspec(dllimport) public: unsigned int __thiscall std::basic_string<wchar_t,struct std::char_traits<wchar_t>,class std::allocator<wchar_t> >::max_size(void)const " (__imp_?max_size@?$basic_string@_WU?$char_traits@_W@std@@V?$allocator@_W@2@@std@@QBEIXZ) referenced in function "class std::basic_istream<wchar_t,struct std::char_traits<wchar_t> > & __cdecl std::operator>><wchar_t,struct std::char_traits<wchar_t>,class std::allocator<wchar_t> >(class std::basic_istream<wchar_t,struct std::char_traits<wchar_t> > &,class std::basic_string<wchar_t,struct std::char_traits<wchar_t>,class std::allocator<wchar_t> > &)" (??$?5_WU?$char_traits@_W@std@@V?$allocator@_W@1@@std@@YAAAV?$basic_istream@_WU?$char_traits@_W@std@@@0@AAV10@AAV?$basic_string@_WU?$char_traits@_W@std@@V?$allocator@_W@2@@0@@Z)
CADlg.obj : error LNK2001: unresolved external symbol "__declspec(dllimport) public: class std::basic_streambuf<wchar_t,struct std::char_traits<wchar_t> > * __thiscall std::basic_ios<wchar_t,struct std::char_traits<wchar_t> >::rdbuf(void)const " (__imp_?rdbuf@?$basic_ios@_WU?$char_traits@_W@std@@@std@@QBEPAV?$basic_streambuf@_WU?$char_traits@_W@std@@@2@XZ)
CA.obj : error LNK2019: unresolved external symbol "__declspec(dllimport) public: unsigned int __thiscall std::basic_string<wchar_t,struct std::char_traits<wchar_t>,class std::allocator<wchar_t> >::max_size(void)const " (__imp_?max_size@?$basic_string@_WU?$char_traits@_W@std@@V?$allocator@_W@2@@std@@QBEIXZ) referenced in function "class std::basic_istream<wchar_t,struct std::char_traits<wchar_t> > & __cdecl std::operator>><wchar_t,struct std::char_traits<wchar_t>,class std::allocator<wchar_t> >(class std::basic_istream<wchar_t,struct std::char_traits<wchar_t> > &,class std::basic_string<wchar_t,struct std::char_traits<wchar_t>,class std::allocator<wchar_t> > &)" (??$?5_WU?$char_traits@_W@std@@V?$allocator@_W@1@@std@@YAAAV?$basic_istream@_WU?$char_traits@_W@std@@@0@AAV10@AAV?$basic_string@_WU?$char_traits@_W@std@@V?$allocator@_W@2@@0@@Z)
加载更多回复（39）
