C Primer Plus 學習筆記：解決 "undefined reference to WinMain@16" 鏈接錯誤

C Primer Plus 學習筆記：解決 "undefined reference to WinMain@16" 鏈接錯誤

在 Windows 環境下使用 MinGW/GCC 編譯 C 程式時，初學者常遇到 undefined reference to `WinMain@16' 錯誤。本文記錄該錯誤成因、排查過程與解決方案，幫助快速定位問題。

錯誤現象

undefined reference to `WinMain@16'

編譯器未報告具體行號錯誤，且程式碼語法看似正確，導致排查困難。

根本原因

經搜尋發現：主函數名稱拼寫錯誤。將 main() 誤寫為 mian()。

錯誤示範

// 錯誤代碼
#include <stdio.h>

int mian() {   // 拼寫錯誤：mian 而非 main
    printf("Hello World\n");
    return 0;
}

為什麼會報 WinMain 錯誤？

Windows 程式進入點預設為 WinMain（GUI 程式）或 main（控制台程式）。當鏈接器找不到 main 時，會嘗試尋找 WinMain 作為備選進入點，兩者皆缺失時拋出此錯誤。

解決方案

1. 檢查主函數拼寫：必須為 main
2. 確認函數簽名符合標準：int main(void)、int main(int argc, char *argv[]) 等
3. 若確需開發 Windows GUI 程式，正確實現 WinMain 並配置編譯選項 -mwindows

正確代碼

#include <stdio.h>

int main(void) {   // 修正拼寫
    printf("Hello World\n");
    return 0;
}

避坑指南

• 拼寫敏感：C 語言區分大小寫，main、mian、Main 完全不同
• 錯誤訊息具迷惑性：鏈接器錯誤常不指向源碼行，需從「缺少進入點」角度思考
• IDE 設定影響：部分 IDE 專案類型（如 Windows Application）預設要求 WinMain，新建專案時選擇 Console Application

相關鏈接錯誤對照

這個看似離譜的錯誤，實則是拼寫疏忽的「偽裝」。養成檢查主函數拼寫的習慣，能省去大量無效排查時間。