VC++ 連結錯誤 LNK2001 完整排查指南：_main、_WinMain、__beginthreadex 未解析符號

Visual C++ 專案建置時出現 error LNK2001: unresolved external symbol，通常是**子系統設定錯誤**、**入口點不符**、**執行期庫不匹配**三大類原因。本文針對四種最常見錯誤訊息，提供精確對應的專案屬性修正步驟（VS6 / VS2005+ 通用）。

錯誤一：unresolved external symbol _main

libcmtd.lib(crt0.obj) : error LNK2001: unresolved external symbol _main

原因：專案設定為 **Console 子系統**，連結器尋找 main() 入口，但專案實為 Windows GUI 程式（含 WinMain）。

修正：

• 專案屬性 → **Linker → System → SubSystem** → 選 **Windows (/SUBSYSTEM:WINDOWS)**。
• 或：專案屬性 → **Linker → Command Line** → 將 /subsystem:console 改為 /subsystem:windows。

錯誤二：unresolved external symbol _WinMain / _WinMain@16

LIBCD.lib(wincrt0.obj) : error LNK2001: unresolved external symbol _WinMain
msvcrtd.lib(crtexew.obj) : error LNK2001: unresolved external symbol _WinMain

原因：專案設定為 **Windows 子系統**，連結器尋找 WinMain，但專案實為 Console 程式（含 main）。

修正：

• 專案屬性 → **Linker → System → SubSystem** → 選 **Console (/SUBSYSTEM:CONSOLE)**。

錯誤三：MFC Unicode 專案入口點錯誤 _WinMain

msvcrtd.lib(crtexew.obj) : error LNK2001: unresolved external symbol _WinMain

原因：MFC Unicode 專案預設入口點為 wWinMainCRTStartup，若專案屬性未正確設定會找不到入口。

修正：

• 專案屬性 → **Linker → Advanced → Entry Point** → 填入 wWinMainCRTStartup。
• 分類選 **Output** (非 General)。

錯誤四：__beginthreadex / __endthreadex 未解析

nafxcwd.lib(thrdcore.obj) : error LNK2001: unresolved external symbol __beginthreadex
nafxcwd.lib(thrdcore.obj) : error LNK2001: unresolved external symbol __endthreadex

原因：MFC 使用多執行緒，需連結**多執行緒執行期庫** (MT/MD)，但專案設定為單執行緒庫。

修正：

• 專案屬性 → **C/C++ → Code Generation → Runtime Library** 選擇：

⚠️ 專案中**所有**靜態庫、DLL 必須使用**相同**執行期庫選項，否則會有多份 errno、malloc 堆疊導致崩潰。

快速自查清單

1. 子系統是否與程式類型匹配？(GUI→Windows, Console→Console)
2. 入口點是否正確？(MFC Unicode→wWinMainCRTStartup)
3. 執行期庫是否全專案一致且為多執行緒？(/MT 或 /MD 系列)
4. 是否遺漏 #include 導致 MFC 符號未引入？
5. 外部庫 .lib 是否加入 **Linker → Input → Additional Dependencies**？

依序檢查上述四項，90% 的 LNK2001 可在分鐘內解決。