常見的問題

以下是一些導致 LNK2019 的常見問題：

• 未連結的物件檔案或包含符號定義的庫。 在 Visual Studio 中，驗證包含定義原始碼檔案是生成，分別連結為專案的一部分。 在命令列中，驗證編譯時包含定義的原始檔，並且所生成物件檔案包含在要連結的檔案列表。

• 符號的宣告不拼寫與符號的定義相同。 驗證在宣告和定義，使用正確的拼寫和大小寫，並且是使用或呼叫該符號的任何位置。

• 使用一個函式，但數量的引數的型別與函式定義不匹配。 函式宣告必須匹配定義。 驗證函式呼叫是否匹配宣告以及宣告是否匹配定義。 呼叫模板函式的程式碼還必須擁有包括與定義相同的模板引數的匹配模板函式宣告。 模板宣告不匹配的示例，請參閱示例 LNK2019e.cpp 示例部分中。

• 宣告但未定義的函式或變數。 這通常意味著在標標頭檔案中，存在宣告，但不匹配定義實現。 對於成員函式或靜態資料成員，實現必須包括類範圍選擇器。 有關示例，請參見 Missing Function Body or Variable。

• 呼叫約定是函式宣告和函式定義之間的差異。 呼叫約定 (__cdecl、 __stdcall、 __fastcall、 or __vectorcall) 作為修飾名稱的一部分進行編碼。 驗證呼叫約定是否相同。

• 符號定義在 C 檔案中，但未使用 extern"C"在 c + + 檔案中進行宣告。 在作為 C 編譯的檔案中定義的符號擁有與在 C++ 檔案中宣告的符號不同的修飾名稱，除非使用了 

  extern "C" 修飾符。 驗證宣告是否匹配每個符號的編譯連結。

  同樣，如果在 C 程式將使用的 C++ 檔案中定義符號，請在定義中使用 extern "C" 。

• 一個符號是定義為靜態，然後更高版本在檔案外部引用。 與 C 不同，在 C++ 中， 全域性常量 擁有 static 連結。 若要避開此限制，你可以在標頭檔案中包括 const 初始化並將該標頭包括在你的 .cpp 檔案中，或者你可以讓變數成為非常量並使用常量引用來訪問它。

• 未定義一個類的靜態成員。 靜態類成員必須擁有唯一的定義，否則它將違反單個定義規則。 無法以內聯方式定義的靜態類成員必須通過使用其完全限定名稱在一個原始檔中進行定義。 如果沒有進行定義，那麼連結器會生成 LNK2019。

• 生成依賴項僅定義為解決方案中專案依賴項。 在 Visual Studio的早期版本中，此級別的依賴項已經足夠。 但是，從 Visual Studio 2010 開始， Visual Studio 要求 專案到專案引用。 如果你的專案沒有專案到專案引用，那麼你可能收到此連結器錯誤。 新增專案到專案引用以修復此錯誤。

• 你通過使用 Windows 應用程式的設定生成了控制檯應用程式。 如果錯誤訊息是類似於WinMain 函式中引用的無法解析外部符號function_name，通過使用連結/subsystem: console而不是/SUBSYSTEM:WINDOWS。 有關此設定的詳細資訊以及如何在 Visual Studio 中設定此屬性的說明，請參閱 /SUBSYSTEM (Specify Subsystem)。

• 為在不同的原始檔中內聯的函式使用不同的編譯器選項。 使用 .cpp 檔案中定義的行內函數並在不同原始檔中混合使用函式內聯編譯器可能會導致 LNK2019。 有關詳細資訊，請參閱 Function Inlining Problems。

• 在其範圍之外使用自動變數。 自動（函式範圍）變數僅可在該函式的範圍內使用。 這些變數不可宣告為 extern ，也不能在其他原始檔中使用。 有關示例，請參見 Automatic (Function Scope) Variables。

• 呼叫內部函式，或將引數型別傳遞到目標體系結構不支援的內部函式。 例如，如果你使用 AVX2 內部函式，但未指定 /ARCH:AVX2 編譯器選項，那麼編譯器會假定該內部函式是外部函式。 編譯器不會生成內聯指令，相反，它會生成一個對與內部函式同名的外部符號的呼叫。 當連結器嘗試找到此缺失函式的定義時，它會生成 LNK2019。 驗證是否只使用了目標體系結構支援的內部函式和型別。

• 混合的程式碼不使用本機 wchar_t 的程式碼。 在 Visual C++ 2005 中完成的 C++ 語言一致性工作讓 wchar_t 成為預設本機型別。 你必須使用 /Zc:wchar_t- 編譯器選項來生成相容使用 Visual C++ 早期版本進行編譯的庫和物件檔案的程式碼。 如果並非所有檔案都已經使用相同的 /Zc:wchar_t 設定進行編譯，那麼型別引用可能不會解析為相容的型別。 驗證所有庫和物件檔案中的 wchar_t 型別是否相容，方法是更新使用的型別或在編譯時使用一致的 /Zc:wchar_t 設定。