/********************************************\
|????歡迎轉(zhuǎn)載, 但請(qǐng)保留作者姓名和原文鏈接, 祝您進(jìn)步并共勉!???? |
\********************************************/
VC++的鏈接錯(cuò)誤LNK2005

作者: Jerry Cat
時(shí)間: 2006/04/19
鏈接: http://www.shnenglu.com/jerysun0818/archive/2006/04/19/5913.html

編程中經(jīng)常能遇到LNK2005錯(cuò)誤——重復(fù)定義錯(cuò)誤，其實(shí)LNK2005錯(cuò)誤并不是一個(gè)很難解決的錯(cuò)誤。弄清楚它形成的原因，就可以輕松解決它了。

造成LNK2005錯(cuò)誤主要有以下幾種情況：
1．重復(fù)定義全局變量。可能存在兩種情況：
A、對(duì)于一些初學(xué)編程的程序員，有時(shí)候會(huì)以為需要使用全局變量的地方就可以使用定義申明一下。其實(shí)這是錯(cuò)誤的，全局變量是針對(duì)整個(gè)工程的。正確的應(yīng)該是在一個(gè)CPP文件中定義如下：int g_Test;那么在使用的CPP文件中就應(yīng)該使用：extern int g_Test即可，如果還是使用int g_Test，那么就會(huì)產(chǎn)生LNK2005錯(cuò)誤，一般錯(cuò)誤錯(cuò)誤信息類似：AAA.obj error LNK2005 int book c？ book@@3HA already defined in BBB.obj。切記的就是不能給變量賦值否則還是會(huì)有LNK2005錯(cuò)誤。
?????? 這里需要的是“聲明”，不是“定義”！根據(jù)C++標(biāo)準(zhǔn)的規(guī)定，一個(gè)變量是聲明，必須同時(shí)滿足兩個(gè)條件，否則就是定義：
(1)聲明必須使用extern關(guān)鍵字；(2)不能給變量賦初值
所以，下面的是聲明:
extern int a;
下面的是定義
int a; int a = 0; extern int a =0;
B、對(duì)于那么編程不是那么嚴(yán)謹(jǐn)?shù)某绦騿T，總是在需要使用變量的文件中隨意定義一個(gè)全局變量，并且對(duì)于變量名也不予考慮，這也往往容易造成變量名重復(fù)，而造成LNK2005錯(cuò)誤。

2．頭文件的包含重復(fù)。往往需要包含的頭文件中含有變量、函數(shù)、類的定義，在其它使用的地方又不得不多次包含之，如果頭文件中沒(méi)有相關(guān)的宏等防止重復(fù)鏈接的措施，那么就會(huì)產(chǎn)生LNK2005錯(cuò)誤。解決辦法是在需要包含的頭文件中做類似的處理：#ifndef MY_H_FILE?? //如果沒(méi)有定義這個(gè)宏
#define MY_H_FILE?? //定義這個(gè)宏
…….?? //頭文件主體內(nèi)容
…….
#endif
上面是使用宏來(lái)做的，也可以使用預(yù)編譯來(lái)做，在頭文件中加入：
#pragma once
//頭文件主體
3．使用第三方的庫(kù)造成的。這種情況主要是C運(yùn)行期函數(shù)庫(kù)和MFC的庫(kù)沖突造成的。具體的辦法就是將那個(gè)提示出錯(cuò)的庫(kù)放到另外一個(gè)庫(kù)的前面。另外選擇不同的C函數(shù)庫(kù)，可能會(huì)引起這個(gè)錯(cuò)誤。微軟和C有兩種C運(yùn)行期函數(shù)庫(kù)，一種是普通的函數(shù)庫(kù)：LIBC.LIB，不支持多線程。另外一種是支持多線程的：msvcrt.lib。如果一個(gè)工程里，這兩種函數(shù)庫(kù)混合使用，可能會(huì)引起這個(gè)錯(cuò)誤，一般情況下它需要MFC的庫(kù)先于C運(yùn)行期函數(shù)庫(kù)被鏈接，因此建議使用支持多線程的msvcrt.lib。所以在使用第三方的庫(kù)之前首先要知道它鏈接的是什么庫(kù)，否則就可能造成LNK2005錯(cuò)誤。如果不得不使用第三方的庫(kù)，可以嘗試按下面所說(shuō)的方法修改，但不能保證一定能解決問(wèn)題，前兩種方法是微軟提供的：
A、選擇VC菜單Project->Settings->Link->Catagory選擇Input，再在Ignore libraries 的Edit欄中填入你需要忽略的庫(kù)，如：Nafxcwd.lib;Libcmtd.lib。然后在Object/library Modules的Edit欄中填入正確的庫(kù)的順序，這里需要你能確定什么是正確的順序，呵呵，God bless you！
B、選擇VC菜單Project->Settings->Link頁(yè)，然后在Project Options的Edit欄中輸入/verbose:lib，這樣就可以在編譯鏈接程序過(guò)程中在輸出窗口看到鏈接的順序了。
C、選擇VC菜單Project->Settings->C/C++頁(yè)，Catagory選擇Code Generation后再在User Runtime libraray中選擇MultiThread DLL等其他庫(kù)，逐一嘗試。

這就是我所遇到過(guò)的LNK2005錯(cuò)誤的幾種情況，肯定還有其他的情況也可能造成這種錯(cuò)誤，所以我不希望你在看完這篇文章以后，再遇到LNK2005錯(cuò)誤時(shí)候，不動(dòng)腦筋的想對(duì)號(hào)入座的排除錯(cuò)誤。編程的過(guò)程就是一個(gè)思考的過(guò)程，所以還是多多開(kāi)動(dòng)你的頭腦，那樣收獲會(huì)更多！
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
支持,我在社區(qū)里也看到了許多LINK 2005錯(cuò)
補(bǔ)充一點(diǎn),就是一次在用第三方庫(kù)時(shí),由于errno被重定義,用多種方法都不能解決,后查找MSDN,發(fā)現(xiàn)link有個(gè)選項(xiàng)/FORCE可以解決,在IDE下
Project->Settings->Link頁(yè),選categroy為custom,將force file output前打勾
但會(huì)有警告
warning LNK4088: image being generated due to /FORCE option; image may not run
但的確解決了問(wèn)題,這是由于VC對(duì)重定義比較嚴(yán)格,像BCB或GCC在庫(kù)中的重定義不會(huì)有任何警告或錯(cuò)誤
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
我發(fā)現(xiàn)的另外一個(gè)出現(xiàn)LINK2005的現(xiàn)象，好像是由于名稱空間而引起的。我在dos下寫的程序沒(méi)有問(wèn)題，但是放在mfc中就出現(xiàn)了這個(gè)鏈接錯(cuò)誤。因?yàn)槠鸪鯃D省事，我在一個(gè)頭文件中寫了using namespace std,并且這個(gè)頭文件我多處使用，另外，我還使用了boost庫(kù)。后來(lái)，問(wèn)題解決的方法非常奇怪，在一個(gè)頭文件中引用其他頭文件，這些頭文件的順序換一下就通過(guò)了，那個(gè)出現(xiàn)問(wèn)題的頭文件中我使用了std::map，當(dāng)我把這種容器使用模板代替后，鏈接就有沒(méi)事了。（例如：template<class coll>）,后來(lái)感到模板技術(shù)還有這種效果,賺了!哈哈
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
What are the C and C++ libraries my program would link with?

????????????????????? Summary Table

?Compile?? Old???????????? New IOStream?? ?Libraries ?Option???? IOStream?? ?or STL???????? ?????? Linked With

?

?/ML??????? No??????????????? No???????????????????LIBC.LIB

?/MLd????? No??????????????? No???????????????????LIBCD.LIB

?/MT??????? No??????????????? No???????????????????LIBCMT.LIB

?/MTd????? No??????????????? No???????????????????LIBCMTD.LIB

?/MD?????? No???????????????? No???????????????????MSVCRT.LIB

?/MDd?????No???????????????? No???????????????????MSVCRTD.LIB

?/ML??????? No??????????????? Yes???????????????????LIBC.LIB,??? ?LIBCP.LIB

?/MLd????? No??????????????? Yes???????????????????LIBCD.LIB,?? LIBCPD.LIB

?/MT??????? No??????????????? Yes???????????????????LIBCMT.LIB,? LIBCPMT.LIB

?/MTd????? No??????????????? Yes???????????????????LIBCMTD.LIB, LIBCPMTD.LIB

?/MD??????? No??????????????? Yes???????????????????MSVCRT.LIB,? MSVCPRT.LIB

?/MDd????? No??????????????? Yes???????????????????MSVCRTD.LIB, MSVCPRTD.LIB

?/ML??????? Yes??????????????? No???????????????????LIBC.LIB,??? ??LIBCI.LIB

?/MLd????? Yes??????????????? No???????????????????LIBCD.LIB,?? ?LIBCID.LIB

?/MT??????? Yes??????????????? No???????????????????LIBCMT.LIB,? ?LIBCIMT.LIB

?/MTd????? Yes??????????????? No???????????????????LIBCMTD.LIB, ?LIBCIMTD.LIB

?/MD??????? Yes??????? ?????? No???????????????????MSVCRT.LIB,? MSVCIRT.LIB

?/MDd????? Yes??????? ?????? No???????????????????MSVCRTD.LIB, MSVCIRTD.LIB

你的程序使用了/ML編譯選項(xiàng),而程序依賴的.lib可能使用/MDd選項(xiàng)編譯,造成鏈接沖突.

統(tǒng)一編譯選項(xiàng)可回避此錯(cuò)誤
Project Settings->C/C++ Tab->Category:CodeGeneration
Use run-time library組合框中選擇Multithread Dll(或Debug Multithread Dll )

Summary Table for CRT DLLs Used

Import Library Linked With	DLLs Used (Visual C++ 5.0|6.0)	DLLs Used (Visual C++ 4.2)	DLLs Used (Visual C++ .NET 2002| Visual C++ .NET 2003)
MSVCRT.LIB	MSVCRT.DLL	MSVCRT.DLL	MSVCRT.DLL
MSVCRTD.LIB	MSVCRTD.DLL	MSVCRTD.DLL	MSVCRTD.DLL
MSVCPRT.LIB	MSVCP(5|6)0.DLL		MSVCP7(0|1).DLL
MSVCPRTD.LIB	MSVCP(5|6)0D.DLL		MSVCP7(0|1)D.DLL
MSVCIRT.LIB	MSVCIRT.DLL	MSVCIRT.DLL
MSVCIRTD.LIB	MSVCIRTD.DLL	MSVCIRTD.DLL

注意：所有相關(guān)工程都應(yīng)該選擇相同編譯選項(xiàng)
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
微軟的MSDN中查到信息的

可能的原因

不慎同時(shí)與單線程庫(kù)和多線程庫(kù)鏈接。確保應(yīng)用程序項(xiàng)目文件只包括適當(dāng)?shù)膸?kù)，并且任何第三方庫(kù)已適當(dāng)創(chuàng)建了單線程或多線程版本。
該符號(hào)為封裝函數(shù)（通過(guò)用 /Gy 編譯創(chuàng)建），包含在多個(gè)文件中，但在各編譯間已改變。重新編譯所有包含 symbol 的文件。
以不同的形式在不同庫(kù)中的兩個(gè)成員對(duì)象中定義了該符號(hào)，并且使用了這兩個(gè)成員對(duì)象。
某個(gè)絕對(duì)符號(hào)被定義兩次，而每次定義的值不同。
頭文件聲明并定義了變量。可能的解決方案有：
在 .h 中聲明變量：extern BOOL MyBool;，然后在 .c 或 .cpp 文件中向它分配：BOOL MyBool = FALSE;。
將變量聲明為 Static。
將變量聲明為 selectany。
當(dāng)將 uuid.lib 與定義 GUID 的其他 .lib 文件（例如 oledb.lib 和 adsiid.lib）一起使用時(shí)。例如：
oledb.lib(oledb_i.obj) : error LNK2005: _IID_ITransactionObject
already defined in uuid.lib(go7.obj)
若要修復(fù)，請(qǐng)將 /FORCE:MULTIPLE 添加到鏈接器命令行選項(xiàng)，并確保 uuid.lib 是引用的第一個(gè)庫(kù)。

有關(guān)更多信息，請(qǐng)參閱知識(shí)庫(kù)文章：

Q148652，PRB: LNK2005 Errors When Link C Run-Time Libraries Are Linked Before MFC Libraries。
Q140440，F(xiàn)IX: Global Overloaded Delete Operator Causes LNK2005。
Q184235，PRB: LNK2005 Errors on New and Delete When Defining _ATL_MIN_CRT。
該錯(cuò)誤之后為致命錯(cuò)誤 LNK1169。
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
有時(shí)候因?yàn)楣こ淌褂昧祟A(yù)編譯頭文件并且是增量編譯，所以當(dāng)你改動(dòng)以后可能也會(huì)出現(xiàn)LNK2005錯(cuò)誤，提示“XXXX已經(jīng)在XXXX.obj文件中定義”的消息，這時(shí)候只要Rebuild All一般都能解決問(wèn)題。這是因?yàn)轭^文件的順序被改動(dòng)等等操作造成的。
最后要說(shuō)明的：事物是在不斷變化中的，C++的標(biāo)準(zhǔn)在變化，編譯器也在變化，所以并不是所有的LNK2005錯(cuò)誤都可以在這里找到答案，但是至少它能給你以提示。學(xué)習(xí)并思考才是正確的！