C語言鏈接錯誤「無法解析的外部符號」：函數聲明與定義不匹配經典案例

錯誤現場

// 聲明
float average(float array[10]);

// 調用
aver = average(score);

// 定義 ❌ 拼寫錯誤：average 寫成 averge
float averge(float array[10]) {  // 少了 'a'
    // ...
}

錯誤本質

Linker LNK2019：聲明了`average`，調用了`average`，但定義的是`averge`。連接器在所有目標文件中找不到`average`的機器碼。

編譯 vs 鏈接 階段對比

常見觸發場景

1. 拼寫錯誤：`average` vs `averge`、`Init` vs `init`（大小寫敏感）
2. 參數不匹配：聲明`void foo(int)`，定義`void foo(float)`
3. 缺少庫文件：聲明了外部庫函數，未鏈接對應`.lib`/`.a`
4. 內聯/模板函數：定義在`.cpp`而非頭文件，導致實例化缺失
5. 調用約定不一致：`__cdecl` vs `__stdcall`修飾符差異

快速定位技巧

// 1. 查看錯誤列表，雙擊跳轉
// 2. 檢查函數簽名：返回類型、名稱、參數列表、調用約定
// 3. 搜索全項目：是否有定義？拼寫是否一致？
// 4. 若為庫函數：項目屬性 → 鏈接器 → 輸入 → 附加依賴項

最佳實踐：頭文件隔離聲明

// math_utils.h
#ifndef MATH_UTILS_H
#define MATH_UTILS_H
float average(float array[], int n);  // 唯一聲明處
#endif

// math_utils.c
#include "math_utils.h"
float average(float array[], int n) {  // 定義與聲明強綁定
    // 實現
}

// main.c
#include "math_utils.h"  // 引用聲明
// 調用 average()

總結

「無法解析的外部符號」= **聲明有、調用有、定義無**。養成「頭文件放聲明、源文件放定義、統一引用頭文件」的習慣，從源頭杜絕此類低級錯誤。