LNK2001: unresolved external symbol 是 VC++ 開發者最頭痛的連結錯誤——編譯通過卻無法產出執行檔。本文系統歸納 8 大類成因，涵蓋編碼錯誤、專案設定、庫版本衝突等，助你快速定位根因。
一、編碼層面錯誤
| # | 成因 | 說明 |
|---|
| 1 | 符號大小寫不一致 | C++ 區分大小寫，var1 vs VAR1 視為不同符號 |
| 2 | 內聯函數定義在 .cpp | 內聯函數必須在標頭檔定義，否則其他編譯單元看不到定義 |
| 3 | 函數參數型別不匹配 | 宣告與定義/呼叫處參數型別不符，產生不同修飾名稱 |
| 4 | 建構/解構函數中呼叫虛擬函數 | 虛表尚未就緒，連結器找不到最終覆寫版本 |
| 5 | 靜態/區域變數跨檔存取 | static 限制連結範圍，全域常數在 C++ 預設內部連結 |
二、編譯/連結設定問題
| # | 設定錯誤 | 現象與對策 |
|---|
| 1 | /NODEFAULTLIB 未顯式引入運行庫 | 補上 libcmt.lib、mfc42.lib 等至「額外相依性」 |
| 2 | Unicode + MFC 專案入口點錯誤 | 設定入口點為 wWinMainCRTStartup 或對應 ANSI 版本 |
| 3 | /MD (動態 CRT) 混用靜態庫 | 統一專案與所有靜態庫的「執行階段程式庫」設定 |
| 4 | /ML (單執行緒靜態) 鏈結 LIBCMT.LIB | _errno 符號衝突，改用一致的 CRT 模式 |
| 5 | Debug/Release 庫混用 | Debug 專案不可連結 Release 庫，反之亦然 |
| 6 | 不同版本 VC++ 庫混用 | 新版庫含舊版無的符號，統一工具鏈版本 |
| 7 | 內聯設定與標頭檔不一致 | 專案開啟 /Ob1//Ob2 但標頭檔缺 inline 關鍵字 |
| 8 | /SUBSYSTEM 或 /ENTRY 設定錯誤 | 主控台/視窗子系統與入口點不匹配 |
快速排查清單
- 雙擊錯誤訊息查看缺失符號名稱；
- 檢查該符號是否在專案中**定義**（非僅宣告）；
- 確認定義處與引用處**呼叫慣例、參數、修飾名**完全一致；
- 清理方案 → 重建（解決殘留 .obj 造成的不一致）；
- 檢查所有專案的 C/C++ → 代碼產生 → 執行階段程式庫 設定一致；
- 若為第三方庫，確認匯入庫
.lib 與標頭檔版本對應。
