腳本之家服務器常用軟件

快捷導航

VC中LINK 2001 和 LINK 2009 的錯誤的解決方法

更新時間：2020年10月04日 12:53:49 作者：薰衣草的旋律

最近將兩個開源C++項目編譯成windows版本的時候遇到很多問題，編譯的時候總是報錯，報的最多的是無法解析的外部符號”，經過近3天的折騰總算都通過了，這里是一些總結

最近將兩個開源C++項目編譯成windows版本的時候遇到很多問題，關鍵是兩個項目經過同事的修改之后，一個項目引用了另一個項目，兩個項目的頭文件中都有一些跨平臺的關于數(shù)據(jù)類型，以及一些通用函數(shù)的定義，所以導致有沖突，編譯的時候總是報錯，報的最多的是“無法解析的外部符號”，經過近3天的折騰總算都通過了，這里是一些總結。

首先，關于VC中的lib，與linux下的靜態(tài)庫是不同的，在VC中編譯動態(tài)庫的時候會生成一個lib和一個對應的dll，使用者在使用的時候需要包含頭文件以及連接到該lib，在發(fā)布最終程序的時候則需要將對應的dll拷貝到發(fā)布目錄。當然也可以使用LoadLibrary的方式在程序中動態(tài)加載dll而不需要使用這個動態(tài)庫生成的lib了。

如果是靜態(tài)庫，編譯之后只會生成一個lib文件，該lib文件非常大，可能有幾十M的大小，(而編譯動態(tài)庫的時候生成的lib可能只有幾十KB或者幾百KB)在使用這個靜態(tài)庫的lib的時候，也需要指定頭文件，與對應的lib庫文件，編譯成功之后就可以直接運行，不需要拷貝額外的文件了。

另外如果A是靜態(tài)庫，B是靜態(tài)庫，并且B使用了A的接口，這個時候在編譯B的時候只需要指定A的頭文件就可以了，不需要指定A的庫文件。如果有一個項目C編譯成可執(zhí)行文件，C使用了B中的接口，這個時候在編譯C的時候，需要同時指定B的頭文件(如果該頭文件中又引用了A的頭文件那可能也要同時指定A的頭文件)，與B的lib庫文件，以及A的lib庫文件。也就是說編譯C的時候要指定之前所有依賴的lib文件。

在windows中編譯動態(tài)庫的時候，如果動態(tài)庫中的函數(shù)需要給別人使用，那么這些函數(shù)或者類則需要被導出，具體如下，假設庫的頭文件為A.h：

#  if defined LIB_A  //這個宏為這個A特有的宏
  #    define DLLEXP __declspec(dllexport)
  #  else
  #    define DLLEXP __declspec(dllimport)
  #  endif
  
  class DLLEXP ExportClass{
  //......
  };

如果在項目B中使用A庫，那么項目B在引用A.h的時候，由于項目B沒有定義LIB_A這個宏，所以實際上使用的是#define DLLEXP __declspec(dllimport)這個定義，也就是說在B項目中，這個ExportClass類的聲明變成導入了，表示該類是從外部庫導入的類。而在項目A中由于定義了LIB_A這個項目特有的宏，所以使用的是#define DLLEXP __declspec(dllexport)這個定義，說明需要編譯成導出給別人用的類。

如果是C語言的庫給C++使用或者C++的庫封裝給C使用則除了要添加__declspec(dllexport)導出聲明之外，還需要添加 external "C" 的聲明，該聲明主要告訴編譯器，編譯的時候生成的函數(shù)的符號表按照C的規(guī)則來生成。因為C編譯器與C++編譯器生成符號表的時候規(guī)則是不一樣的。

那么編譯的時候報告LINK錯誤，無法解析的外部符號，一般是下面幾種原因造成的：

1. 最常見的情況是要么沒有指定引用庫的路徑，或者沒有指定所以依賴的庫文件名字。
2. 如果正確指定了lib庫路徑，以及l(fā)ib庫名，那檢查一下該lib中是否有該符號的實現(xiàn)，也就是說頭文件中聲明了該符號，但是該庫文件中卻沒有具體的實現(xiàn)。
3. 如果庫文件中確實實現(xiàn)了符號的定義，那么檢查一下lib庫的版本是否與正確(32位或者64位)。還有如果報告的是某一個函數(shù)無法解析，則要對比一下該函數(shù)在庫中的實現(xiàn)與在頭文件中的聲明是否一致(特別是函數(shù)的參數(shù)個數(shù)與參數(shù)類型是否完全一致)。
4. 有一種情況就是在編譯lib的時候，該lib是動態(tài)庫，但是沒有添加導出聲明，導致該庫中的函數(shù)并不對外導出(靜態(tài)庫不需要導出聲明，加了反而會有問題)，那么使用者在鏈接的時候也會報無法解析的符號。
5. 還有一種非常隱蔽的情況，這也是我遇到的情況，在項目A中將一些基本的數(shù)據(jù)類型做了typedef，例如類似下面的定義：

typedef unsigned char uint8_t;
typedef unsigned short int uint16_t;

然后A項目的導出函數(shù) FUNC(uint8_t); 使用了該uint8_t，但是在B項目中對上述的 uint8_t 又做了另外一套定義 (如果A和B是兩個開源項目則很有可能出現(xiàn)這種沖突)，如下：

typedef unsigned __int8 uint8_t;

那么在B中使用A的時候，使用的uint8_t是B的定義，實際上函數(shù)的聲明變成了 FUNC(unsigned __int8) 但是在A的lib庫文件的實現(xiàn)里面使用的是FUNC(unsigned char)也就是說該函數(shù)FUNC的聲明與定義并不匹配，那么當然也會報告找不到符號了，這種情況一般是在兩個開源項目混合使用的時候就會出現(xiàn)沖突。

6. 編譯靜態(tài)庫的時候，如果靜態(tài)庫B引用了靜態(tài)庫A中的內容，此時在B的項目里面都不需要指定A的庫路徑，只需要指定A的相關頭文件，就可以編譯通過，如果里面有什么問題，那么會在最終使用B的項目的時候，鏈接的時候報出來。例如C項目使用了B，那么在編譯C的時候需要同時添加A和B兩個庫，如果之前B使用A的過程中有問題的話，那么在編譯C的時候就會報告LINK錯誤，而不是在編譯B的時候報告(除非是語法錯誤)。

7. 如果項目C使用了B庫與A庫，但是B與A是有依賴關系的，那么在C的工程設置中，也要指定B和A的先后關系，否則也可能會報錯。

8. 如果在連接項目的時候報告下面的錯誤：

無法找到外部符號 _CrtDbgReportW 或者是
error LNK2038: 檢測到“_ITERATOR_DEBUG_LEVEL”的不匹配項: 值“2”不匹配值“0” (有可能是值"0"不匹配"2")

這種錯誤一般是在Release版本的項目中使用了Debug的庫，但是有時候明明看到我們編譯的庫都是Release版本的，使用那個庫的時候卻還是報告這個問題，這個現(xiàn)象可能是，編譯那個庫的時候，雖然選擇的是Release方式編譯，但是在項目的宏定義中卻定義了_DEBUG宏，導致該還是會被認為是Debug的版本。

VC中常見LINK錯誤及解決方案

. Windows子系統(tǒng)設置錯誤, 提示:
libcmtd.lib(crt0.obj) : error LNK2001: unresolved external symbol _main
Windows項目要使用Windows子系統(tǒng), 而不是Console, 可以這樣設置:

[Project] --> [Settings] --> 選擇"Link"屬性頁,
在Project Options中將/subsystem:console改成/subsystem:windows

2. Console子系統(tǒng)設置錯誤, 提示:
LIBCD.lib(wincrt0.obj) : error LNK2001: unresolved external symbol _WinMain@16

控制臺項目要使用Console子系統(tǒng), 而不是Windows, 設置:

[Project] --> [Settings] --> 選擇"Link"屬性頁,
在Project Options中將/subsystem:windows改成/subsystem:console

3. 程序入口設置錯誤, 提示:
msvcrtd.lib(crtexew.obj) : error LNK2001: unresolved external symbol _WinMain@16

通常, MFC項目的程序入口函數(shù)是WinMain, 如果編譯項目的Unicode版本, 程序入口必須改為wWinMainCRTStartup, 所以需要重新設置程序入口:

[Project] --> [Settings] --> 選擇"Link"屬性頁,
在Category中選擇Output,
再在Entry-point symbol中填入wWinMainCRTStartup, 即可

4. 線程運行時庫設置錯誤, 提示:
nafxcwd.lib(thrdcore.obj) : error LNK2001: unresolved external symbol __beginthreadex
nafxcwd.lib(thrdcore.obj) : error LNK2001: unresolved external symbol __endthreadex

這是因為MFC要使用多線程時庫, 需要更改設置:

[Project] --> [Settings] --> 選擇"C/C++"屬性頁,
在Category中選擇Code Generation,
再在Use run-time library中選擇Debug Multithreaded或者multithreaded
咸魚游俠(75374355) 12:11:11

其中,
Single-Threaded 單線程靜態(tài)鏈接庫(release版本)
Multithreaded 多線程靜態(tài)鏈接庫(release版本)
multithreaded DLL 多線程動態(tài)鏈接庫(release版本)
Debug Single-Threaded 單線程靜態(tài)鏈接庫(debug版本)
Debug Multithreaded 多線程靜態(tài)鏈接庫(debug版本)
Debug Multithreaded DLL 多線程動態(tài)鏈接庫(debug版本)

單線程: 不需要多線程調用時, 多用在DOS環(huán)境下
多線程: 可以并發(fā)運行
靜態(tài)庫: 直接將庫與程序Link, 可以脫離MFC庫運行
動態(tài)庫: 需要相應的DLL動態(tài)庫, 程序才能運行
release版本: 正式發(fā)布時使用
debug版本: 調試階段使用

初學者在學習VC++的過程中，遇到的LNK2001錯誤的錯誤消息主要為：

　　unresolved external symbol “symbol”（不確定的外部“符號”）。

　　如果連接程序不能在所有的庫和目標文件內找到所引用的函數(shù)、變量或標簽，將產生此錯誤消息。一般來說，發(fā)生錯誤的原因有兩個：一是所引用的函數(shù)、變量不存在、拼寫不正確或者使用錯誤；其次可能使用了不同版本的連接庫。

　　以下是可能產生LNK2001錯誤的原因：

　　一．由于編碼錯誤導致的LNK2001

　　1．不相匹配的程序代碼或模塊定義(.DEF)文件能導致LNK2001。例如, 如果在C++源文件內聲明了一變量“var1”，卻試圖在另一文件內以變量“VAR1”訪問該變量,將發(fā)生該錯誤。

　　2．如果使用的內聯(lián)函數(shù)是在.CPP文件內定義的，而不是在頭文件內定義將導致LNK2001錯誤。

　　3．調用函數(shù)時如果所用的參數(shù)類型同函數(shù)聲明時的類型不符將會產生LNK2001。

　　4．試圖從基類的構造函數(shù)或析構函數(shù)中調用虛擬函數(shù)時將會導致LNK2001。

　　5．要注意函數(shù)和變量的可公用性，只有全局變量、函數(shù)是可公用的。靜態(tài)函數(shù)和靜態(tài)變量具有相同的使用范圍限制。當試圖從文件外部訪問任何沒有在該文件內聲明的靜態(tài)變量時將導致編譯錯誤或LNK2001。

　　函數(shù)內聲明的變量(局部變量) 只能在該函數(shù)的范圍內使用。

C++ 的全局常量只有靜態(tài)連接性能。這不同于C，如果試圖在C++的多個文件內使用全局變量也會產生LNK2001錯誤。一種解決的方法是需要時在頭文件中加入該常量的初始化代碼，并在.CPP文件中包含該頭文件；另一種方法是使用時給該變量賦以常數(shù)。

　　二．由于編譯和鏈接的設置而造成的LNK2001

　　1．如果編譯時使用的是/NOD(/NODEFAULTLIB)選項，程序所需要的運行庫和MFC庫在連接時由編譯器寫入目標文件模塊，但除非在文件中明確包含這些庫名，否則這些庫不會被鏈接進工程文件。在這種情況下使用/NOD將導致錯誤LNK2001。

　　2．如果沒有為wWinMainCRTStartup設定程序入口，在使用Unicode和MFC時將得到“unresolved external on _WinMain@16”的LNK2001錯誤信息。

　　3．使用/MD選項編譯時,既然所有的運行庫都被保留在動態(tài)鏈接庫之內，源文件中對“func”的引用，在目標文件里即對“__imp__func” 的引用。如果試圖使用靜態(tài)庫LIBC.LIB或LIBCMT.LIB進行連接，將在__imp__func上發(fā)生LNK2001；如果不使用/MD選項編
　　譯，在使用MSVCxx.LIB連接時也會發(fā)生LNK2001。

　　4．使用/ML選項編譯時，如用LIBCMT.LIB鏈接會在_errno上發(fā)生LNK2001。

　　5．當編譯調試版的應用程序時，如果采用發(fā)行版模態(tài)庫進行連接也會產生LNK2001；同樣，使用調試版模態(tài)庫連接發(fā)行版應用程序時也會產生相同的問題。

　　6．不同版本的庫和編譯器的混合使用也能產生問題，因為新版的庫里可能包含早先的版本沒有的符號和說明。

　　編程時打開了函數(shù)內聯(lián)（/Ob1或/Ob2)，但是在描述該函數(shù)的相應頭文件里卻關閉了函數(shù)內聯(lián)（沒有inline關鍵字），這時將得到該錯誤信息。為避免該問題的發(fā)生，應該在相應的頭文件中用inline關鍵字標志內聯(lián)函數(shù)。

　　8．不正確的/SUBSYSTEM或/ENTRY設置也能導致LNK2001

到此這篇關于VC中LINK 2001 和 LINK 2009 的錯誤的解決方法的文章就介紹到這了,更多相關VC中常見LINK錯誤及解決方案內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！