VC++ 6.0 連結錯誤 LNK2001/LNK2005 完整解析與解決方案

前言

連結階段錯誤（LNKxxxx）與編譯錯誤不同，發生在所有 .obj 檔產生後、合併為 .exe/.dll 時。本文詳細解析兩大經典連結錯誤：LNK2001（未解析外部符號）與 LNK2005（符號重複定義）。

錯誤 1：LNK2001: unresolved external symbol _main

error LNK2001: unresolved external symbol _main

直譯：找不到 _main 符號

原因：專案中缺少 main() / WinMain() 進入點

檢查清單：

• 拼寫是否正確：main 全小寫
• 專案類型：Console 應用需 main，GUI 應用需 WinMain
• 是否誤將含 main 的 .cpp 排除在建置外

錯誤 2：LNK2005: _main already defined in xxxx.obj

error LNK2005: _main already defined in xxx.obj

直譯：_main 已在 xxx.obj 中定義

根本原因：**單一專案中存在多個 main 函式**

典型發生情境

1. 寫完第一個程式，未關閉專案直接「新增檔案」寫第二個程式
2. 專案下累積多個 .cpp，每個都有 main()
3. 切換到「File View」→「Source Files」可看到多個 .cpp

Workspace / Project 概念釐清

解決方案

方法 1：正確建立新專案流程

1. 完成一個程式後，File → Close Workspace 完全關閉
2. 或直接關閉 VC6 重新開啟
3. File → New → Projects 建立新專案

方法 2：移除多餘 .cpp

在 File View 中右鍵多餘的 .cpp → Remove From Project（不刪除檔案，只移出專案）。

方法 3：條件編譯（不推薦初學者）

// 只在特定條件編譯 main
#if defined(TEST_PROGRAM_1)
int main() { ... }
#elif defined(TEST_PROGRAM_2)
int main() { ... }
#endif

預防檢查清單

• [ ] 每次寫新程式前確認已 Close Workspace
• [ ] File View 中 Source Files 只有一個含 main 的 .cpp
• [ ] 專案設定 → C/C++ → Preprocessor definitions 確認無衝突
• [ ] 習慣「寫一個、關一個」或重啟 IDE

延伸：其他常見 LNK 錯誤